1 /****************************************************************************** 2 * 3 * This file is provided under a dual BSD/GPLv2 license. When using or 4 * redistributing this file, you may do so under either license. 5 * 6 * GPL LICENSE SUMMARY 7 * 8 * Copyright(c) 2008 - 2014, 2020 Intel Corporation. All rights reserved. 9 * Copyright(c) 2013 - 2014 Intel Mobile Communications GmbH 10 * 11 * This program is free software; you can redistribute it and/or modify 12 * it under the terms of version 2 of the GNU General Public License as 13 * published by the Free Software Foundation. 14 * 15 * This program is distributed in the hope that it will be useful, but 16 * WITHOUT ANY WARRANTY; without even the implied warranty of 17 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU 18 * General Public License for more details. 19 * 20 * The full GNU General Public License is included in this distribution 21 * in the file called COPYING. 22 * 23 * Contact Information: 24 * Intel Linux Wireless <linuxwifi@intel.com> 25 * Intel Corporation, 5200 N.E. Elam Young Parkway, Hillsboro, OR 97124-6497 26 * 27 * BSD LICENSE 28 * 29 * Copyright(c) 2005 - 2014, 2020 Intel Corporation. All rights reserved. 30 * Copyright(c) 2013 - 2014 Intel Mobile Communications GmbH 31 * All rights reserved. 32 * 33 * Redistribution and use in source and binary forms, with or without 34 * modification, are permitted provided that the following conditions 35 * are met: 36 * 37 * * Redistributions of source code must retain the above copyright 38 * notice, this list of conditions and the following disclaimer. 39 * * Redistributions in binary form must reproduce the above copyright 40 * notice, this list of conditions and the following disclaimer in 41 * the documentation and/or other materials provided with the 42 * distribution. 43 * * Neither the name Intel Corporation nor the names of its 44 * contributors may be used to endorse or promote products derived 45 * from this software without specific prior written permission. 46 * 47 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 48 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 49 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR 50 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT 51 * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, 52 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT 53 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 54 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 55 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 56 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE 57 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 58 *****************************************************************************/ 59 60 #ifndef __iwl_drv_h__ 61 #define __iwl_drv_h__ 62 #include <linux/export.h> 63 64 /* for all modules */ 65 #define DRV_NAME "iwlwifi" 66 #define DRV_AUTHOR "Intel Corporation <linuxwifi@intel.com>" 67 68 /* radio config bits (actual values from NVM definition) */ 69 #define NVM_RF_CFG_DASH_MSK(x) (x & 0x3) /* bits 0-1 */ 70 #define NVM_RF_CFG_STEP_MSK(x) ((x >> 2) & 0x3) /* bits 2-3 */ 71 #define NVM_RF_CFG_TYPE_MSK(x) ((x >> 4) & 0x3) /* bits 4-5 */ 72 #define NVM_RF_CFG_PNUM_MSK(x) ((x >> 6) & 0x3) /* bits 6-7 */ 73 #define NVM_RF_CFG_TX_ANT_MSK(x) ((x >> 8) & 0xF) /* bits 8-11 */ 74 #define NVM_RF_CFG_RX_ANT_MSK(x) ((x >> 12) & 0xF) /* bits 12-15 */ 75 76 #define EXT_NVM_RF_CFG_FLAVOR_MSK(x) ((x) & 0xF) 77 #define EXT_NVM_RF_CFG_DASH_MSK(x) (((x) >> 4) & 0xF) 78 #define EXT_NVM_RF_CFG_STEP_MSK(x) (((x) >> 8) & 0xF) 79 #define EXT_NVM_RF_CFG_TYPE_MSK(x) (((x) >> 12) & 0xFFF) 80 #define EXT_NVM_RF_CFG_TX_ANT_MSK(x) (((x) >> 24) & 0xF) 81 #define EXT_NVM_RF_CFG_RX_ANT_MSK(x) (((x) >> 28) & 0xF) 82 83 /** 84 * DOC: Driver system flows - drv component 85 * 86 * This component implements the system flows such as bus enumeration, bus 87 * removal. Bus dependent parts of system flows (such as iwl_pci_probe) are in 88 * bus specific files (transport files). This is the code that is common among 89 * different buses. 90 * 91 * This component is also in charge of managing the several implementations of 92 * the wifi flows: it will allow to have several fw API implementation. These 93 * different implementations will differ in the way they implement mac80211's 94 * handlers too. 95 96 * The init flow wrt to the drv component looks like this: 97 * 1) The bus specific component is called from module_init 98 * 2) The bus specific component registers the bus driver 99 * 3) The bus driver calls the probe function 100 * 4) The bus specific component configures the bus 101 * 5) The bus specific component calls to the drv bus agnostic part 102 * (iwl_drv_start) 103 * 6) iwl_drv_start fetches the fw ASYNC, iwl_req_fw_callback 104 * 7) iwl_req_fw_callback parses the fw file 105 * 8) iwl_req_fw_callback starts the wifi implementation to matches the fw 106 */ 107 108 struct iwl_drv; 109 struct iwl_trans; 110 struct iwl_cfg; 111 /** 112 * iwl_drv_start - start the drv 113 * 114 * @trans_ops: the ops of the transport 115 * 116 * starts the driver: fetches the firmware. This should be called by bus 117 * specific system flows implementations. For example, the bus specific probe 118 * function should do bus related operations only, and then call to this 119 * function. It returns the driver object or %NULL if an error occurred. 120 */ 121 struct iwl_drv *iwl_drv_start(struct iwl_trans *trans); 122 123 /** 124 * iwl_drv_stop - stop the drv 125 * 126 * @drv: 127 * 128 * Stop the driver. This should be called by bus specific system flows 129 * implementations. For example, the bus specific remove function should first 130 * call this function and then do the bus related operations only. 131 */ 132 void iwl_drv_stop(struct iwl_drv *drv); 133 134 /* 135 * exported symbol management 136 * 137 * The driver can be split into multiple modules, in which case some symbols 138 * must be exported for the sub-modules. However, if it's not split and 139 * everything is built-in, then we can avoid that. 140 */ 141 #ifdef CONFIG_IWLWIFI_OPMODE_MODULAR 142 #define IWL_EXPORT_SYMBOL(sym) EXPORT_SYMBOL_GPL(sym) 143 #else 144 #define IWL_EXPORT_SYMBOL(sym) 145 #endif 146 147 /* max retry for init flow */ 148 #define IWL_MAX_INIT_RETRY 2 149 150 #endif /* __iwl_drv_h__ */ 151