iwl-3945.h 11 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311
  1. /******************************************************************************
  2. *
  3. * Copyright(c) 2003 - 2009 Intel Corporation. All rights reserved.
  4. *
  5. * This program is free software; you can redistribute it and/or modify it
  6. * under the terms of version 2 of the GNU General Public License as
  7. * published by the Free Software Foundation.
  8. *
  9. * This program is distributed in the hope that it will be useful, but WITHOUT
  10. * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
  11. * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
  12. * more details.
  13. *
  14. * You should have received a copy of the GNU General Public License along with
  15. * this program; if not, write to the Free Software Foundation, Inc.,
  16. * 51 Franklin Street, Fifth Floor, Boston, MA 02110, USA
  17. *
  18. * The full GNU General Public License is included in this distribution in the
  19. * file called LICENSE.
  20. *
  21. * Contact Information:
  22. * Intel Linux Wireless <ilw@linux.intel.com>
  23. * Intel Corporation, 5200 N.E. Elam Young Parkway, Hillsboro, OR 97124-6497
  24. *
  25. *****************************************************************************/
  26. /*
  27. * Please use this file (iwl-3945.h) for driver implementation definitions.
  28. * Please use iwl-3945-commands.h for uCode API definitions.
  29. * Please use iwl-3945-hw.h for hardware-related definitions.
  30. */
  31. #ifndef __iwl_3945_h__
  32. #define __iwl_3945_h__
  33. #include <linux/pci.h> /* for struct pci_device_id */
  34. #include <linux/kernel.h>
  35. #include <net/ieee80211_radiotap.h>
  36. /*used for rfkill*/
  37. #include <linux/rfkill.h>
  38. #include <linux/input.h>
  39. /* Hardware specific file defines the PCI IDs table for that hardware module */
  40. extern struct pci_device_id iwl3945_hw_card_ids[];
  41. #include "iwl-csr.h"
  42. #include "iwl-prph.h"
  43. #include "iwl-fh.h"
  44. #include "iwl-3945-hw.h"
  45. #include "iwl-debug.h"
  46. #include "iwl-power.h"
  47. #include "iwl-dev.h"
  48. #include "iwl-3945-led.h"
  49. /* Highest firmware API version supported */
  50. #define IWL3945_UCODE_API_MAX 2
  51. /* Lowest firmware API version supported */
  52. #define IWL3945_UCODE_API_MIN 1
  53. #define IWL3945_FW_PRE "iwlwifi-3945-"
  54. #define _IWL3945_MODULE_FIRMWARE(api) IWL3945_FW_PRE #api ".ucode"
  55. #define IWL3945_MODULE_FIRMWARE(api) _IWL3945_MODULE_FIRMWARE(api)
  56. /* Default noise level to report when noise measurement is not available.
  57. * This may be because we're:
  58. * 1) Not associated (4965, no beacon statistics being sent to driver)
  59. * 2) Scanning (noise measurement does not apply to associated channel)
  60. * 3) Receiving CCK (3945 delivers noise info only for OFDM frames)
  61. * Use default noise value of -127 ... this is below the range of measurable
  62. * Rx dBm for either 3945 or 4965, so it can indicate "unmeasurable" to user.
  63. * Also, -127 works better than 0 when averaging frames with/without
  64. * noise info (e.g. averaging might be done in app); measured dBm values are
  65. * always negative ... using a negative value as the default keeps all
  66. * averages within an s8's (used in some apps) range of negative values. */
  67. #define IWL_NOISE_MEAS_NOT_AVAILABLE (-127)
  68. /* Module parameters accessible from iwl-*.c */
  69. extern struct iwl_mod_params iwl3945_mod_params;
  70. struct iwl3945_sta_priv {
  71. struct iwl3945_rs_sta *rs_sta;
  72. };
  73. enum iwl3945_antenna {
  74. IWL_ANTENNA_DIVERSITY,
  75. IWL_ANTENNA_MAIN,
  76. IWL_ANTENNA_AUX
  77. };
  78. /*
  79. * RTS threshold here is total size [2347] minus 4 FCS bytes
  80. * Per spec:
  81. * a value of 0 means RTS on all data/management packets
  82. * a value > max MSDU size means no RTS
  83. * else RTS for data/management frames where MPDU is larger
  84. * than RTS value.
  85. */
  86. #define DEFAULT_RTS_THRESHOLD 2347U
  87. #define MIN_RTS_THRESHOLD 0U
  88. #define MAX_RTS_THRESHOLD 2347U
  89. #define MAX_MSDU_SIZE 2304U
  90. #define MAX_MPDU_SIZE 2346U
  91. #define DEFAULT_BEACON_INTERVAL 100U
  92. #define DEFAULT_SHORT_RETRY_LIMIT 7U
  93. #define DEFAULT_LONG_RETRY_LIMIT 4U
  94. #include "iwl-agn-rs.h"
  95. #define IWL_TX_FIFO_AC0 0
  96. #define IWL_TX_FIFO_AC1 1
  97. #define IWL_TX_FIFO_AC2 2
  98. #define IWL_TX_FIFO_AC3 3
  99. #define IWL_TX_FIFO_HCCA_1 5
  100. #define IWL_TX_FIFO_HCCA_2 6
  101. #define IWL_TX_FIFO_NONE 7
  102. /* Minimum number of queues. MAX_NUM is defined in hw specific files */
  103. #define IWL_MIN_NUM_QUEUES 4
  104. #define IEEE80211_DATA_LEN 2304
  105. #define IEEE80211_4ADDR_LEN 30
  106. #define IEEE80211_HLEN (IEEE80211_4ADDR_LEN)
  107. #define IEEE80211_FRAME_LEN (IEEE80211_DATA_LEN + IEEE80211_HLEN)
  108. struct iwl3945_frame {
  109. union {
  110. struct ieee80211_hdr frame;
  111. struct iwl3945_tx_beacon_cmd beacon;
  112. u8 raw[IEEE80211_FRAME_LEN];
  113. u8 cmd[360];
  114. } u;
  115. struct list_head list;
  116. };
  117. #define SEQ_TO_SN(seq) (((seq) & IEEE80211_SCTL_SEQ) >> 4)
  118. #define SN_TO_SEQ(ssn) (((ssn) << 4) & IEEE80211_SCTL_SEQ)
  119. #define MAX_SN ((IEEE80211_SCTL_SEQ) >> 4)
  120. /*
  121. * RX related structures and functions
  122. */
  123. #define RX_FREE_BUFFERS 64
  124. #define RX_LOW_WATERMARK 8
  125. #define SUP_RATE_11A_MAX_NUM_CHANNELS 8
  126. #define SUP_RATE_11B_MAX_NUM_CHANNELS 4
  127. #define SUP_RATE_11G_MAX_NUM_CHANNELS 12
  128. #define IWL_SUPPORTED_RATES_IE_LEN 8
  129. #define SCAN_INTERVAL 100
  130. #define STATUS_HCMD_ACTIVE 0 /* host command in progress */
  131. #define STATUS_HCMD_SYNC_ACTIVE 1 /* sync host command in progress */
  132. #define STATUS_INT_ENABLED 2
  133. #define STATUS_RF_KILL_HW 3
  134. #define STATUS_RF_KILL_SW 4
  135. #define STATUS_INIT 5
  136. #define STATUS_ALIVE 6
  137. #define STATUS_READY 7
  138. #define STATUS_TEMPERATURE 8
  139. #define STATUS_GEO_CONFIGURED 9
  140. #define STATUS_EXIT_PENDING 10
  141. #define STATUS_IN_SUSPEND 11
  142. #define STATUS_STATISTICS 12
  143. #define STATUS_SCANNING 13
  144. #define STATUS_SCAN_ABORTING 14
  145. #define STATUS_SCAN_HW 15
  146. #define STATUS_POWER_PMI 16
  147. #define STATUS_FW_ERROR 17
  148. #define STATUS_CONF_PENDING 18
  149. #define MAX_TID_COUNT 9
  150. #define IWL_INVALID_RATE 0xFF
  151. #define IWL_INVALID_VALUE -1
  152. #define STA_PS_STATUS_WAKE 0
  153. #define STA_PS_STATUS_SLEEP 1
  154. struct iwl3945_ibss_seq {
  155. u8 mac[ETH_ALEN];
  156. u16 seq_num;
  157. u16 frag_num;
  158. unsigned long packet_time;
  159. struct list_head list;
  160. };
  161. #define IWL_RX_HDR(x) ((struct iwl3945_rx_frame_hdr *)(\
  162. x->u.rx_frame.stats.payload + \
  163. x->u.rx_frame.stats.phy_count))
  164. #define IWL_RX_END(x) ((struct iwl3945_rx_frame_end *)(\
  165. IWL_RX_HDR(x)->payload + \
  166. le16_to_cpu(IWL_RX_HDR(x)->len)))
  167. #define IWL_RX_STATS(x) (&x->u.rx_frame.stats)
  168. #define IWL_RX_DATA(x) (IWL_RX_HDR(x)->payload)
  169. /******************************************************************************
  170. *
  171. * Functions implemented in iwl-base.c which are forward declared here
  172. * for use by iwl-*.c
  173. *
  174. *****************************************************************************/
  175. struct iwl3945_addsta_cmd;
  176. extern int iwl3945_send_add_station(struct iwl_priv *priv,
  177. struct iwl3945_addsta_cmd *sta, u8 flags);
  178. extern u8 iwl3945_add_station(struct iwl_priv *priv, const u8 *bssid,
  179. int is_ap, u8 flags);
  180. extern int iwl3945_power_init_handle(struct iwl_priv *priv);
  181. extern int iwl3945_eeprom_init(struct iwl_priv *priv);
  182. extern int iwl3945_calc_db_from_ratio(int sig_ratio);
  183. extern int iwl3945_calc_sig_qual(int rssi_dbm, int noise_dbm);
  184. extern int iwl3945_tx_queue_init(struct iwl_priv *priv,
  185. struct iwl_tx_queue *txq, int count, u32 id);
  186. extern void iwl3945_rx_replenish(void *data);
  187. extern void iwl3945_tx_queue_free(struct iwl_priv *priv, struct iwl_tx_queue *txq);
  188. extern int iwl3945_send_cmd_pdu(struct iwl_priv *priv, u8 id, u16 len,
  189. const void *data);
  190. extern int __must_check iwl3945_send_cmd(struct iwl_priv *priv,
  191. struct iwl_host_cmd *cmd);
  192. extern unsigned int iwl3945_fill_beacon_frame(struct iwl_priv *priv,
  193. struct ieee80211_hdr *hdr,int left);
  194. /*
  195. * Currently used by iwl-3945-rs... look at restructuring so that it doesn't
  196. * call this... todo... fix that.
  197. */
  198. extern u8 iwl3945_sync_station(struct iwl_priv *priv, int sta_id,
  199. u16 tx_rate, u8 flags);
  200. /******************************************************************************
  201. *
  202. * Functions implemented in iwl-[34]*.c which are forward declared here
  203. * for use by iwl-base.c
  204. *
  205. * NOTE: The implementation of these functions are hardware specific
  206. * which is why they are in the hardware specific files (vs. iwl-base.c)
  207. *
  208. * Naming convention --
  209. * iwl3945_ <-- Its part of iwlwifi (should be changed to iwl3945_)
  210. * iwl3945_hw_ <-- Hardware specific (implemented in iwl-XXXX.c by all HW)
  211. * iwlXXXX_ <-- Hardware specific (implemented in iwl-XXXX.c for XXXX)
  212. * iwl3945_bg_ <-- Called from work queue context
  213. * iwl3945_mac_ <-- mac80211 callback
  214. *
  215. ****************************************************************************/
  216. extern void iwl3945_hw_rx_handler_setup(struct iwl_priv *priv);
  217. extern void iwl3945_hw_setup_deferred_work(struct iwl_priv *priv);
  218. extern void iwl3945_hw_cancel_deferred_work(struct iwl_priv *priv);
  219. extern int iwl3945_hw_rxq_stop(struct iwl_priv *priv);
  220. extern int iwl3945_hw_set_hw_params(struct iwl_priv *priv);
  221. extern int iwl3945_hw_nic_init(struct iwl_priv *priv);
  222. extern int iwl3945_hw_nic_stop_master(struct iwl_priv *priv);
  223. extern void iwl3945_hw_txq_ctx_free(struct iwl_priv *priv);
  224. extern void iwl3945_hw_txq_ctx_stop(struct iwl_priv *priv);
  225. extern int iwl3945_hw_nic_reset(struct iwl_priv *priv);
  226. extern int iwl3945_hw_txq_attach_buf_to_tfd(struct iwl_priv *priv,
  227. struct iwl_tx_queue *txq,
  228. dma_addr_t addr, u16 len,
  229. u8 reset, u8 pad);
  230. extern void iwl3945_hw_txq_free_tfd(struct iwl_priv *priv,
  231. struct iwl_tx_queue *txq);
  232. extern int iwl3945_hw_get_temperature(struct iwl_priv *priv);
  233. extern int iwl3945_hw_tx_queue_init(struct iwl_priv *priv,
  234. struct iwl_tx_queue *txq);
  235. extern unsigned int iwl3945_hw_get_beacon_cmd(struct iwl_priv *priv,
  236. struct iwl3945_frame *frame, u8 rate);
  237. void iwl3945_hw_build_tx_cmd_rate(struct iwl_priv *priv, struct iwl_cmd *cmd,
  238. struct ieee80211_tx_info *info,
  239. struct ieee80211_hdr *hdr,
  240. int sta_id, int tx_id);
  241. extern int iwl3945_hw_reg_send_txpower(struct iwl_priv *priv);
  242. extern int iwl3945_hw_reg_set_txpower(struct iwl_priv *priv, s8 power);
  243. extern void iwl3945_hw_rx_statistics(struct iwl_priv *priv,
  244. struct iwl_rx_mem_buffer *rxb);
  245. extern void iwl3945_disable_events(struct iwl_priv *priv);
  246. extern int iwl4965_get_temperature(const struct iwl_priv *priv);
  247. /**
  248. * iwl3945_hw_find_station - Find station id for a given BSSID
  249. * @bssid: MAC address of station ID to find
  250. *
  251. * NOTE: This should not be hardware specific but the code has
  252. * not yet been merged into a single common layer for managing the
  253. * station tables.
  254. */
  255. extern u8 iwl3945_hw_find_station(struct iwl_priv *priv, const u8 *bssid);
  256. extern int iwl3945_hw_channel_switch(struct iwl_priv *priv, u16 channel);
  257. /*
  258. * Forward declare iwl-3945.c functions for iwl-base.c
  259. */
  260. extern __le32 iwl3945_get_antenna_flags(const struct iwl_priv *priv);
  261. extern int iwl3945_init_hw_rate_table(struct iwl_priv *priv);
  262. extern void iwl3945_reg_txpower_periodic(struct iwl_priv *priv);
  263. extern int iwl3945_txpower_set_from_eeprom(struct iwl_priv *priv);
  264. extern u8 iwl3945_sync_sta(struct iwl_priv *priv, int sta_id,
  265. u16 tx_rate, u8 flags);
  266. extern const struct iwl_channel_info *iwl3945_get_channel_info(
  267. const struct iwl_priv *priv, enum ieee80211_band band, u16 channel);
  268. extern int iwl3945_rs_next_rate(struct iwl_priv *priv, int rate);
  269. /* Requires full declaration of iwl_priv before including */
  270. #include "iwl-io.h"
  271. #endif