iwl-shared.h 22 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722
  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) 2007 - 2011 Intel Corporation. All rights reserved.
  9. *
  10. * This program is free software; you can redistribute it and/or modify
  11. * it under the terms of version 2 of the GNU General Public License as
  12. * published by the Free Software Foundation.
  13. *
  14. * This program is distributed in the hope that it will be useful, but
  15. * WITHOUT ANY WARRANTY; without even the implied warranty of
  16. * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
  17. * General Public License for more details.
  18. *
  19. * You should have received a copy of the GNU General Public License
  20. * along with this program; if not, write to the Free Software
  21. * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110,
  22. * USA
  23. *
  24. * The full GNU General Public License is included in this distribution
  25. * in the file called LICENSE.GPL.
  26. *
  27. * Contact Information:
  28. * Intel Linux Wireless <ilw@linux.intel.com>
  29. * Intel Corporation, 5200 N.E. Elam Young Parkway, Hillsboro, OR 97124-6497
  30. *
  31. * BSD LICENSE
  32. *
  33. * Copyright(c) 2005 - 2011 Intel Corporation. All rights reserved.
  34. * All rights reserved.
  35. *
  36. * Redistribution and use in source and binary forms, with or without
  37. * modification, are permitted provided that the following conditions
  38. * are met:
  39. *
  40. * * Redistributions of source code must retain the above copyright
  41. * notice, this list of conditions and the following disclaimer.
  42. * * Redistributions in binary form must reproduce the above copyright
  43. * notice, this list of conditions and the following disclaimer in
  44. * the documentation and/or other materials provided with the
  45. * distribution.
  46. * * Neither the name Intel Corporation nor the names of its
  47. * contributors may be used to endorse or promote products derived
  48. * from this software without specific prior written permission.
  49. *
  50. * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
  51. * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
  52. * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
  53. * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
  54. * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
  55. * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
  56. * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
  57. * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
  58. * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  59. * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
  60. * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  61. *
  62. *****************************************************************************/
  63. #ifndef __iwl_shared_h__
  64. #define __iwl_shared_h__
  65. #include <linux/types.h>
  66. #include <linux/spinlock.h>
  67. #include <linux/mutex.h>
  68. #include <linux/gfp.h>
  69. #include <linux/mm.h> /* for page_address */
  70. #include <net/mac80211.h>
  71. #include "iwl-commands.h"
  72. /**
  73. * DOC: shared area - role and goal
  74. *
  75. * The shared area contains all the data exported by the upper layer to the
  76. * other layers. Since the bus and transport layer shouldn't dereference
  77. * iwl_priv, all the data needed by the upper layer and the transport / bus
  78. * layer must be here.
  79. * The shared area also holds pointer to all the other layers. This allows a
  80. * layer to call a function from another layer.
  81. *
  82. * NOTE: All the layers hold a pointer to the shared area which must be shrd.
  83. * A few macros assume that (_m)->shrd points to the shared area no matter
  84. * what _m is.
  85. *
  86. * gets notifications about enumeration, suspend, resume.
  87. * For the moment, the bus layer is not a linux kernel module as itself, and
  88. * the module_init function of the driver must call the bus specific
  89. * registration functions. These functions are listed at the end of this file.
  90. * For the moment, there is only one implementation of this interface: PCI-e.
  91. * This implementation is iwl-pci.c
  92. */
  93. struct iwl_bus;
  94. struct iwl_priv;
  95. struct iwl_trans;
  96. struct iwl_sensitivity_ranges;
  97. struct iwl_trans_ops;
  98. #define DRV_NAME "iwlwifi"
  99. #define IWLWIFI_VERSION "in-tree:"
  100. #define DRV_COPYRIGHT "Copyright(c) 2003-2011 Intel Corporation"
  101. #define DRV_AUTHOR "<ilw@linux.intel.com>"
  102. extern struct iwl_mod_params iwlagn_mod_params;
  103. /**
  104. * struct iwl_mod_params
  105. *
  106. * Holds the module parameters
  107. *
  108. * @sw_crypto: using hardware encryption, default = 0
  109. * @num_of_queues: number of tx queue, HW dependent
  110. * @disable_11n: 11n capabilities enabled, default = 0
  111. * @amsdu_size_8K: enable 8K amsdu size, default = 1
  112. * @antenna: both antennas (use diversity), default = 0
  113. * @restart_fw: restart firmware, default = 1
  114. * @plcp_check: enable plcp health check, default = true
  115. * @ack_check: disable ack health check, default = false
  116. * @wd_disable: enable stuck queue check, default = 0
  117. * @bt_coex_active: enable bt coex, default = true
  118. * @led_mode: system default, default = 0
  119. * @no_sleep_autoadjust: disable autoadjust, default = true
  120. * @power_save: disable power save, default = false
  121. * @power_level: power level, default = 1
  122. * @debug_level: levels are IWL_DL_*
  123. * @ant_coupling: antenna coupling in dB, default = 0
  124. * @bt_ch_announce: BT channel inhibition, default = enable
  125. * @wanted_ucode_alternative: ucode alternative to use, default = 1
  126. * @auto_agg: enable agg. without check, default = true
  127. */
  128. struct iwl_mod_params {
  129. int sw_crypto;
  130. int num_of_queues;
  131. int disable_11n;
  132. int amsdu_size_8K;
  133. int antenna;
  134. int restart_fw;
  135. bool plcp_check;
  136. bool ack_check;
  137. int wd_disable;
  138. bool bt_coex_active;
  139. int led_mode;
  140. bool no_sleep_autoadjust;
  141. bool power_save;
  142. int power_level;
  143. u32 debug_level;
  144. int ant_coupling;
  145. bool bt_ch_announce;
  146. int wanted_ucode_alternative;
  147. bool auto_agg;
  148. };
  149. /**
  150. * struct iwl_hw_params
  151. *
  152. * Holds the module parameters
  153. *
  154. * @max_txq_num: Max # Tx queues supported
  155. * @num_ampdu_queues: num of ampdu queues
  156. * @tx_chains_num: Number of TX chains
  157. * @rx_chains_num: Number of RX chains
  158. * @valid_tx_ant: usable antennas for TX
  159. * @valid_rx_ant: usable antennas for RX
  160. * @ht40_channel: is 40MHz width possible: BIT(IEEE80211_BAND_XXX)
  161. * @sku: sku read from EEPROM
  162. * @rx_page_order: Rx buffer page order
  163. * @max_inst_size: for ucode use
  164. * @max_data_size: for ucode use
  165. * @ct_kill_threshold: temperature threshold - in hw dependent unit
  166. * @ct_kill_exit_threshold: when to reeable the device - in hw dependent unit
  167. * relevant for 1000, 6000 and up
  168. * @wd_timeout: TX queues watchdog timeout
  169. * @calib_rt_cfg: setup runtime calibrations for the hw
  170. * @struct iwl_sensitivity_ranges: range of sensitivity values
  171. */
  172. struct iwl_hw_params {
  173. u8 max_txq_num;
  174. u8 num_ampdu_queues;
  175. u8 tx_chains_num;
  176. u8 rx_chains_num;
  177. u8 valid_tx_ant;
  178. u8 valid_rx_ant;
  179. u8 ht40_channel;
  180. bool shadow_reg_enable;
  181. u16 sku;
  182. u32 rx_page_order;
  183. u32 max_inst_size;
  184. u32 max_data_size;
  185. u32 ct_kill_threshold;
  186. u32 ct_kill_exit_threshold;
  187. unsigned int wd_timeout;
  188. u32 calib_rt_cfg;
  189. const struct iwl_sensitivity_ranges *sens;
  190. };
  191. /**
  192. * enum iwl_agg_state
  193. *
  194. * The state machine of the BA agreement establishment / tear down.
  195. * These states relate to a specific RA / TID.
  196. *
  197. * @IWL_AGG_OFF: aggregation is not used
  198. * @IWL_AGG_ON: aggregation session is up
  199. * @IWL_EMPTYING_HW_QUEUE_ADDBA: establishing a BA session - waiting for the
  200. * HW queue to be empty from packets for this RA /TID.
  201. * @IWL_EMPTYING_HW_QUEUE_DELBA: tearing down a BA session - waiting for the
  202. * HW queue to be empty from packets for this RA /TID.
  203. */
  204. enum iwl_agg_state {
  205. IWL_AGG_OFF = 0,
  206. IWL_AGG_ON,
  207. IWL_EMPTYING_HW_QUEUE_ADDBA,
  208. IWL_EMPTYING_HW_QUEUE_DELBA,
  209. };
  210. /**
  211. * struct iwl_ht_agg - aggregation state machine
  212. * This structs holds the states for the BA agreement establishment and tear
  213. * down. It also holds the state during the BA session itself. This struct is
  214. * duplicated for each RA / TID.
  215. * @rate_n_flags: Rate at which Tx was attempted. Holds the data between the
  216. * Tx response (REPLY_TX), and the block ack notification
  217. * (REPLY_COMPRESSED_BA).
  218. * @state: state of the BA agreement establishment / tear down.
  219. * @txq_id: Tx queue used by the BA session - used by the transport layer.
  220. * Needed by the upper layer for debugfs only.
  221. * @ssn: the first packet to be sent in AGG HW queue in Tx AGG start flow, or
  222. * the first packet to be sent in legacy HW queue in Tx AGG stop flow.
  223. * Basically when next_reclaimed reaches ssn, we can tell mac80211 that
  224. * we are ready to finish the Tx AGG stop / start flow.
  225. * @wait_for_ba: Expect block-ack before next Tx reply
  226. */
  227. struct iwl_ht_agg {
  228. u32 rate_n_flags;
  229. enum iwl_agg_state state;
  230. u16 txq_id;
  231. u16 ssn;
  232. bool wait_for_ba;
  233. };
  234. /**
  235. * struct iwl_tid_data - one for each RA / TID
  236. * This structs holds the states for each RA / TID.
  237. * @seq_number: the next WiFi sequence number to use
  238. * @next_reclaimed: the WiFi sequence number of the next packet to be acked.
  239. * This is basically (last acked packet++).
  240. * @agg: aggregation state machine
  241. */
  242. struct iwl_tid_data {
  243. u16 seq_number;
  244. u16 next_reclaimed;
  245. struct iwl_ht_agg agg;
  246. };
  247. /**
  248. * enum iwl_ucode_type
  249. *
  250. * The type of ucode currently loaded on the hardware.
  251. *
  252. * @IWL_UCODE_NONE: No ucode loaded
  253. * @IWL_UCODE_REGULAR: Normal runtime ucode
  254. * @IWL_UCODE_INIT: Initial ucode
  255. * @IWL_UCODE_WOWLAN: Wake on Wireless enabled ucode
  256. */
  257. enum iwl_ucode_type {
  258. IWL_UCODE_NONE,
  259. IWL_UCODE_REGULAR,
  260. IWL_UCODE_INIT,
  261. IWL_UCODE_WOWLAN,
  262. };
  263. /**
  264. * struct iwl_notification_wait - notification wait entry
  265. * @list: list head for global list
  266. * @fn: function called with the notification
  267. * @cmd: command ID
  268. *
  269. * This structure is not used directly, to wait for a
  270. * notification declare it on the stack, and call
  271. * iwlagn_init_notification_wait() with appropriate
  272. * parameters. Then do whatever will cause the ucode
  273. * to notify the driver, and to wait for that then
  274. * call iwlagn_wait_notification().
  275. *
  276. * Each notification is one-shot. If at some point we
  277. * need to support multi-shot notifications (which
  278. * can't be allocated on the stack) we need to modify
  279. * the code for them.
  280. */
  281. struct iwl_notification_wait {
  282. struct list_head list;
  283. void (*fn)(struct iwl_trans *trans, struct iwl_rx_packet *pkt,
  284. void *data);
  285. void *fn_data;
  286. u8 cmd;
  287. bool triggered, aborted;
  288. };
  289. /**
  290. * enum iwl_pa_type - Power Amplifier type
  291. * @IWL_PA_SYSTEM: based on uCode configuration
  292. * @IWL_PA_INTERNAL: use Internal only
  293. */
  294. enum iwl_pa_type {
  295. IWL_PA_SYSTEM = 0,
  296. IWL_PA_INTERNAL = 1,
  297. };
  298. /*
  299. * LED mode
  300. * IWL_LED_DEFAULT: use device default
  301. * IWL_LED_RF_STATE: turn LED on/off based on RF state
  302. * LED ON = RF ON
  303. * LED OFF = RF OFF
  304. * IWL_LED_BLINK: adjust led blink rate based on blink table
  305. */
  306. enum iwl_led_mode {
  307. IWL_LED_DEFAULT,
  308. IWL_LED_RF_STATE,
  309. IWL_LED_BLINK,
  310. };
  311. /**
  312. * struct iwl_cfg
  313. * @name: Offical name of the device
  314. * @fw_name_pre: Firmware filename prefix. The api version and extension
  315. * (.ucode) will be added to filename before loading from disk. The
  316. * filename is constructed as fw_name_pre<api>.ucode.
  317. * @ucode_api_max: Highest version of uCode API supported by driver.
  318. * @ucode_api_ok: oldest version of the uCode API that is OK to load
  319. * without a warning, for use in transitions
  320. * @ucode_api_min: Lowest version of uCode API supported by driver.
  321. * @valid_tx_ant: valid transmit antenna
  322. * @valid_rx_ant: valid receive antenna
  323. * @sku: sku information from EEPROM
  324. * @eeprom_ver: EEPROM version
  325. * @eeprom_calib_ver: EEPROM calibration version
  326. * @lib: pointer to the lib ops
  327. * @additional_nic_config: additional nic configuration
  328. * @base_params: pointer to basic parameters
  329. * @ht_params: point to ht patameters
  330. * @bt_params: pointer to bt parameters
  331. * @pa_type: used by 6000 series only to identify the type of Power Amplifier
  332. * @need_temp_offset_calib: need to perform temperature offset calibration
  333. * @no_xtal_calib: some devices do not need crystal calibration data,
  334. * don't send it to those
  335. * @scan_rx_antennas: available antenna for scan operation
  336. * @led_mode: 0=blinking, 1=On(RF On)/Off(RF Off)
  337. * @adv_pm: advance power management
  338. * @rx_with_siso_diversity: 1x1 device with rx antenna diversity
  339. * @internal_wimax_coex: internal wifi/wimax combo device
  340. * @iq_invert: I/Q inversion
  341. * @temp_offset_v2: support v2 of temperature offset calibration
  342. *
  343. * We enable the driver to be backward compatible wrt API version. The
  344. * driver specifies which APIs it supports (with @ucode_api_max being the
  345. * highest and @ucode_api_min the lowest). Firmware will only be loaded if
  346. * it has a supported API version.
  347. *
  348. * The ideal usage of this infrastructure is to treat a new ucode API
  349. * release as a new hardware revision.
  350. */
  351. struct iwl_cfg {
  352. /* params specific to an individual device within a device family */
  353. const char *name;
  354. const char *fw_name_pre;
  355. const unsigned int ucode_api_max;
  356. const unsigned int ucode_api_ok;
  357. const unsigned int ucode_api_min;
  358. u8 valid_tx_ant;
  359. u8 valid_rx_ant;
  360. u16 sku;
  361. u16 eeprom_ver;
  362. u16 eeprom_calib_ver;
  363. const struct iwl_lib_ops *lib;
  364. void (*additional_nic_config)(struct iwl_priv *priv);
  365. /* params not likely to change within a device family */
  366. struct iwl_base_params *base_params;
  367. /* params likely to change within a device family */
  368. struct iwl_ht_params *ht_params;
  369. struct iwl_bt_params *bt_params;
  370. enum iwl_pa_type pa_type; /* if used set to IWL_PA_SYSTEM */
  371. const bool need_temp_offset_calib; /* if used set to true */
  372. const bool no_xtal_calib;
  373. u8 scan_rx_antennas[IEEE80211_NUM_BANDS];
  374. enum iwl_led_mode led_mode;
  375. const bool adv_pm;
  376. const bool rx_with_siso_diversity;
  377. const bool internal_wimax_coex;
  378. const bool iq_invert;
  379. const bool temp_offset_v2;
  380. };
  381. /**
  382. * struct iwl_shared - shared fields for all the layers of the driver
  383. *
  384. * @dbg_level_dev: dbg level set per device. Prevails on
  385. * iwlagn_mod_params.debug_level if set (!= 0)
  386. * @ucode_owner: IWL_OWNERSHIP_*
  387. * @cmd_queue: command queue number
  388. * @status: STATUS_*
  389. * @valid_contexts: microcode/device supports multiple contexts
  390. * @bus: pointer to the bus layer data
  391. * @cfg: see struct iwl_cfg
  392. * @priv: pointer to the upper layer data
  393. * @hw_params: see struct iwl_hw_params
  394. * @workqueue: the workqueue used by all the layers of the driver
  395. * @lock: protect general shared data
  396. * @sta_lock: protects the station table.
  397. * If lock and sta_lock are needed, lock must be acquired first.
  398. * @mutex:
  399. * @eeprom: pointer to the eeprom/OTP image
  400. * @ucode_type: indicator of loaded ucode image
  401. * @notif_waits: things waiting for notification
  402. * @notif_wait_lock: lock protecting notification
  403. * @notif_waitq: head of notification wait queue
  404. * @device_pointers: pointers to ucode event tables
  405. */
  406. struct iwl_shared {
  407. #ifdef CONFIG_IWLWIFI_DEBUG
  408. u32 dbg_level_dev;
  409. #endif /* CONFIG_IWLWIFI_DEBUG */
  410. #define IWL_OWNERSHIP_DRIVER 0
  411. #define IWL_OWNERSHIP_TM 1
  412. u8 ucode_owner;
  413. u8 cmd_queue;
  414. unsigned long status;
  415. bool wowlan;
  416. u8 valid_contexts;
  417. struct iwl_bus *bus;
  418. struct iwl_cfg *cfg;
  419. struct iwl_priv *priv;
  420. struct iwl_trans *trans;
  421. struct iwl_hw_params hw_params;
  422. struct workqueue_struct *workqueue;
  423. spinlock_t lock;
  424. spinlock_t sta_lock;
  425. struct mutex mutex;
  426. struct iwl_tid_data tid_data[IWLAGN_STATION_COUNT][IWL_MAX_TID_COUNT];
  427. wait_queue_head_t wait_command_queue;
  428. /* eeprom -- this is in the card's little endian byte order */
  429. u8 *eeprom;
  430. /* ucode related variables */
  431. enum iwl_ucode_type ucode_type;
  432. /* notification wait support */
  433. struct list_head notif_waits;
  434. spinlock_t notif_wait_lock;
  435. wait_queue_head_t notif_waitq;
  436. struct {
  437. u32 error_event_table;
  438. u32 log_event_table;
  439. } device_pointers;
  440. };
  441. /*Whatever _m is (iwl_trans, iwl_priv, iwl_bus, these macros will work */
  442. #define priv(_m) ((_m)->shrd->priv)
  443. #define cfg(_m) ((_m)->shrd->cfg)
  444. #define bus(_m) ((_m)->shrd->bus)
  445. #define trans(_m) ((_m)->shrd->trans)
  446. #define hw_params(_m) ((_m)->shrd->hw_params)
  447. #ifdef CONFIG_IWLWIFI_DEBUG
  448. /*
  449. * iwl_get_debug_level: Return active debug level for device
  450. *
  451. * Using sysfs it is possible to set per device debug level. This debug
  452. * level will be used if set, otherwise the global debug level which can be
  453. * set via module parameter is used.
  454. */
  455. static inline u32 iwl_get_debug_level(struct iwl_shared *shrd)
  456. {
  457. if (shrd->dbg_level_dev)
  458. return shrd->dbg_level_dev;
  459. else
  460. return iwlagn_mod_params.debug_level;
  461. }
  462. #else
  463. static inline u32 iwl_get_debug_level(struct iwl_shared *shrd)
  464. {
  465. return iwlagn_mod_params.debug_level;
  466. }
  467. #endif
  468. static inline void iwl_free_pages(struct iwl_shared *shrd, unsigned long page)
  469. {
  470. free_pages(page, shrd->hw_params.rx_page_order);
  471. }
  472. /**
  473. * iwl_queue_inc_wrap - increment queue index, wrap back to beginning
  474. * @index -- current index
  475. * @n_bd -- total number of entries in queue (must be power of 2)
  476. */
  477. static inline int iwl_queue_inc_wrap(int index, int n_bd)
  478. {
  479. return ++index & (n_bd - 1);
  480. }
  481. /**
  482. * iwl_queue_dec_wrap - decrement queue index, wrap back to end
  483. * @index -- current index
  484. * @n_bd -- total number of entries in queue (must be power of 2)
  485. */
  486. static inline int iwl_queue_dec_wrap(int index, int n_bd)
  487. {
  488. return --index & (n_bd - 1);
  489. }
  490. struct iwl_rx_mem_buffer {
  491. dma_addr_t page_dma;
  492. struct page *page;
  493. struct list_head list;
  494. };
  495. #define rxb_addr(r) page_address(r->page)
  496. /*
  497. * mac80211 queues, ACs, hardware queues, FIFOs.
  498. *
  499. * Cf. http://wireless.kernel.org/en/developers/Documentation/mac80211/queues
  500. *
  501. * Mac80211 uses the following numbers, which we get as from it
  502. * by way of skb_get_queue_mapping(skb):
  503. *
  504. * VO 0
  505. * VI 1
  506. * BE 2
  507. * BK 3
  508. *
  509. *
  510. * Regular (not A-MPDU) frames are put into hardware queues corresponding
  511. * to the FIFOs, see comments in iwl-prph.h. Aggregated frames get their
  512. * own queue per aggregation session (RA/TID combination), such queues are
  513. * set up to map into FIFOs too, for which we need an AC->FIFO mapping. In
  514. * order to map frames to the right queue, we also need an AC->hw queue
  515. * mapping. This is implemented here.
  516. *
  517. * Due to the way hw queues are set up (by the hw specific modules like
  518. * iwl-4965.c, iwl-5000.c etc.), the AC->hw queue mapping is the identity
  519. * mapping.
  520. */
  521. static const u8 tid_to_ac[] = {
  522. IEEE80211_AC_BE,
  523. IEEE80211_AC_BK,
  524. IEEE80211_AC_BK,
  525. IEEE80211_AC_BE,
  526. IEEE80211_AC_VI,
  527. IEEE80211_AC_VI,
  528. IEEE80211_AC_VO,
  529. IEEE80211_AC_VO
  530. };
  531. static inline int get_ac_from_tid(u16 tid)
  532. {
  533. if (likely(tid < ARRAY_SIZE(tid_to_ac)))
  534. return tid_to_ac[tid];
  535. /* no support for TIDs 8-15 yet */
  536. return -EINVAL;
  537. }
  538. enum iwl_rxon_context_id {
  539. IWL_RXON_CTX_BSS,
  540. IWL_RXON_CTX_PAN,
  541. NUM_IWL_RXON_CTX
  542. };
  543. int iwl_probe(struct iwl_bus *bus, const struct iwl_trans_ops *trans_ops,
  544. struct iwl_cfg *cfg);
  545. void __devexit iwl_remove(struct iwl_priv * priv);
  546. struct iwl_device_cmd;
  547. int __must_check iwl_rx_dispatch(struct iwl_priv *priv,
  548. struct iwl_rx_mem_buffer *rxb,
  549. struct iwl_device_cmd *cmd);
  550. int iwlagn_hw_valid_rtc_data_addr(u32 addr);
  551. void iwl_start_tx_ba_trans_ready(struct iwl_priv *priv,
  552. enum iwl_rxon_context_id ctx,
  553. u8 sta_id, u8 tid);
  554. void iwl_stop_tx_ba_trans_ready(struct iwl_priv *priv,
  555. enum iwl_rxon_context_id ctx,
  556. u8 sta_id, u8 tid);
  557. void iwl_set_hw_rfkill_state(struct iwl_priv *priv, bool state);
  558. void iwl_nic_config(struct iwl_priv *priv);
  559. void iwl_free_skb(struct iwl_priv *priv, struct sk_buff *skb);
  560. void iwl_apm_stop(struct iwl_priv *priv);
  561. int iwl_apm_init(struct iwl_priv *priv);
  562. void iwlagn_fw_error(struct iwl_priv *priv, bool ondemand);
  563. const char *get_cmd_string(u8 cmd);
  564. bool iwl_check_for_ct_kill(struct iwl_priv *priv);
  565. void iwl_stop_sw_queue(struct iwl_priv *priv, u8 ac);
  566. void iwl_wake_sw_queue(struct iwl_priv *priv, u8 ac);
  567. /* notification wait support */
  568. void iwl_abort_notification_waits(struct iwl_shared *shrd);
  569. void __acquires(wait_entry)
  570. iwl_init_notification_wait(struct iwl_shared *shrd,
  571. struct iwl_notification_wait *wait_entry,
  572. u8 cmd,
  573. void (*fn)(struct iwl_trans *trans,
  574. struct iwl_rx_packet *pkt,
  575. void *data),
  576. void *fn_data);
  577. int __must_check __releases(wait_entry)
  578. iwl_wait_notification(struct iwl_shared *shrd,
  579. struct iwl_notification_wait *wait_entry,
  580. unsigned long timeout);
  581. void __releases(wait_entry)
  582. iwl_remove_notification(struct iwl_shared *shrd,
  583. struct iwl_notification_wait *wait_entry);
  584. #ifdef CONFIG_IWLWIFI_DEBUGFS
  585. void iwl_reset_traffic_log(struct iwl_priv *priv);
  586. #endif /* CONFIG_IWLWIFI_DEBUGFS */
  587. #ifdef CONFIG_IWLWIFI_DEBUG
  588. void iwl_print_rx_config_cmd(struct iwl_priv *priv,
  589. enum iwl_rxon_context_id ctxid);
  590. #else
  591. static inline void iwl_print_rx_config_cmd(struct iwl_priv *priv,
  592. enum iwl_rxon_context_id ctxid)
  593. {
  594. }
  595. #endif
  596. #define IWL_CMD(x) case x: return #x
  597. #define IWL_MASK(lo, hi) ((1 << (hi)) | ((1 << (hi)) - (1 << (lo))))
  598. #define IWL_TRAFFIC_ENTRIES (256)
  599. #define IWL_TRAFFIC_ENTRY_SIZE (64)
  600. /*****************************************************
  601. * DRIVER STATUS FUNCTIONS
  602. ******************************************************/
  603. #define STATUS_HCMD_ACTIVE 0 /* host command in progress */
  604. /* 1 is unused (used to be STATUS_HCMD_SYNC_ACTIVE) */
  605. #define STATUS_INT_ENABLED 2
  606. #define STATUS_RF_KILL_HW 3
  607. #define STATUS_CT_KILL 4
  608. #define STATUS_INIT 5
  609. #define STATUS_ALIVE 6
  610. #define STATUS_READY 7
  611. #define STATUS_TEMPERATURE 8
  612. #define STATUS_GEO_CONFIGURED 9
  613. #define STATUS_EXIT_PENDING 10
  614. #define STATUS_STATISTICS 12
  615. #define STATUS_SCANNING 13
  616. #define STATUS_SCAN_ABORTING 14
  617. #define STATUS_SCAN_HW 15
  618. #define STATUS_POWER_PMI 16
  619. #define STATUS_FW_ERROR 17
  620. #define STATUS_DEVICE_ENABLED 18
  621. #define STATUS_CHANNEL_SWITCH_PENDING 19
  622. #define STATUS_SCAN_COMPLETE 20
  623. static inline int iwl_is_ready(struct iwl_shared *shrd)
  624. {
  625. /* The adapter is 'ready' if READY and GEO_CONFIGURED bits are
  626. * set but EXIT_PENDING is not */
  627. return test_bit(STATUS_READY, &shrd->status) &&
  628. test_bit(STATUS_GEO_CONFIGURED, &shrd->status) &&
  629. !test_bit(STATUS_EXIT_PENDING, &shrd->status);
  630. }
  631. static inline int iwl_is_alive(struct iwl_shared *shrd)
  632. {
  633. return test_bit(STATUS_ALIVE, &shrd->status);
  634. }
  635. static inline int iwl_is_init(struct iwl_shared *shrd)
  636. {
  637. return test_bit(STATUS_INIT, &shrd->status);
  638. }
  639. static inline int iwl_is_rfkill_hw(struct iwl_shared *shrd)
  640. {
  641. return test_bit(STATUS_RF_KILL_HW, &shrd->status);
  642. }
  643. static inline int iwl_is_rfkill(struct iwl_shared *shrd)
  644. {
  645. return iwl_is_rfkill_hw(shrd);
  646. }
  647. static inline int iwl_is_ctkill(struct iwl_shared *shrd)
  648. {
  649. return test_bit(STATUS_CT_KILL, &shrd->status);
  650. }
  651. static inline int iwl_is_ready_rf(struct iwl_shared *shrd)
  652. {
  653. if (iwl_is_rfkill(shrd))
  654. return 0;
  655. return iwl_is_ready(shrd);
  656. }
  657. #endif /* #__iwl_shared_h__ */