iwl-3945.h 12 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344
  1. /******************************************************************************
  2. *
  3. * Copyright(c) 2003 - 2008 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-3945-hw.h"
  44. #include "iwl-debug.h"
  45. #include "iwl-power.h"
  46. #include "iwl-dev.h"
  47. #include "iwl-3945-led.h"
  48. /* Highest firmware API version supported */
  49. #define IWL3945_UCODE_API_MAX 2
  50. /* Lowest firmware API version supported */
  51. #define IWL3945_UCODE_API_MIN 1
  52. #define IWL3945_FW_PRE "iwlwifi-3945-"
  53. #define _IWL3945_MODULE_FIRMWARE(api) IWL3945_FW_PRE #api ".ucode"
  54. #define IWL3945_MODULE_FIRMWARE(api) _IWL3945_MODULE_FIRMWARE(api)
  55. /* Default noise level to report when noise measurement is not available.
  56. * This may be because we're:
  57. * 1) Not associated (4965, no beacon statistics being sent to driver)
  58. * 2) Scanning (noise measurement does not apply to associated channel)
  59. * 3) Receiving CCK (3945 delivers noise info only for OFDM frames)
  60. * Use default noise value of -127 ... this is below the range of measurable
  61. * Rx dBm for either 3945 or 4965, so it can indicate "unmeasurable" to user.
  62. * Also, -127 works better than 0 when averaging frames with/without
  63. * noise info (e.g. averaging might be done in app); measured dBm values are
  64. * always negative ... using a negative value as the default keeps all
  65. * averages within an s8's (used in some apps) range of negative values. */
  66. #define IWL_NOISE_MEAS_NOT_AVAILABLE (-127)
  67. /* Module parameters accessible from iwl-*.c */
  68. extern struct iwl_mod_params iwl3945_mod_params;
  69. struct iwl3945_sta_priv {
  70. struct iwl3945_rs_sta *rs_sta;
  71. };
  72. enum iwl3945_antenna {
  73. IWL_ANTENNA_DIVERSITY,
  74. IWL_ANTENNA_MAIN,
  75. IWL_ANTENNA_AUX
  76. };
  77. /*
  78. * RTS threshold here is total size [2347] minus 4 FCS bytes
  79. * Per spec:
  80. * a value of 0 means RTS on all data/management packets
  81. * a value > max MSDU size means no RTS
  82. * else RTS for data/management frames where MPDU is larger
  83. * than RTS value.
  84. */
  85. #define IWL_RX_BUF_SIZE 3000U
  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. int iwl3945_x2_queue_used(const struct iwl_queue *q, int i);
  95. #define MAX_NUM_OF_TBS (20)
  96. /* One for each TFD */
  97. struct iwl3945_tx_info {
  98. struct sk_buff *skb[MAX_NUM_OF_TBS];
  99. };
  100. #include "iwl-agn-rs.h"
  101. #define IWL_TX_FIFO_AC0 0
  102. #define IWL_TX_FIFO_AC1 1
  103. #define IWL_TX_FIFO_AC2 2
  104. #define IWL_TX_FIFO_AC3 3
  105. #define IWL_TX_FIFO_HCCA_1 5
  106. #define IWL_TX_FIFO_HCCA_2 6
  107. #define IWL_TX_FIFO_NONE 7
  108. /* Minimum number of queues. MAX_NUM is defined in hw specific files */
  109. #define IWL_MIN_NUM_QUEUES 4
  110. #define IEEE80211_DATA_LEN 2304
  111. #define IEEE80211_4ADDR_LEN 30
  112. #define IEEE80211_HLEN (IEEE80211_4ADDR_LEN)
  113. #define IEEE80211_FRAME_LEN (IEEE80211_DATA_LEN + IEEE80211_HLEN)
  114. struct iwl3945_frame {
  115. union {
  116. struct ieee80211_hdr frame;
  117. struct iwl3945_tx_beacon_cmd beacon;
  118. u8 raw[IEEE80211_FRAME_LEN];
  119. u8 cmd[360];
  120. } u;
  121. struct list_head list;
  122. };
  123. #define SEQ_TO_SN(seq) (((seq) & IEEE80211_SCTL_SEQ) >> 4)
  124. #define SN_TO_SEQ(ssn) (((ssn) << 4) & IEEE80211_SCTL_SEQ)
  125. #define MAX_SN ((IEEE80211_SCTL_SEQ) >> 4)
  126. /*
  127. * RX related structures and functions
  128. */
  129. #define RX_FREE_BUFFERS 64
  130. #define RX_LOW_WATERMARK 8
  131. #define SUP_RATE_11A_MAX_NUM_CHANNELS 8
  132. #define SUP_RATE_11B_MAX_NUM_CHANNELS 4
  133. #define SUP_RATE_11G_MAX_NUM_CHANNELS 12
  134. #define IWL_SUPPORTED_RATES_IE_LEN 8
  135. #define SCAN_INTERVAL 100
  136. #define STATUS_HCMD_ACTIVE 0 /* host command in progress */
  137. #define STATUS_HCMD_SYNC_ACTIVE 1 /* sync host command in progress */
  138. #define STATUS_INT_ENABLED 2
  139. #define STATUS_RF_KILL_HW 3
  140. #define STATUS_RF_KILL_SW 4
  141. #define STATUS_INIT 5
  142. #define STATUS_ALIVE 6
  143. #define STATUS_READY 7
  144. #define STATUS_TEMPERATURE 8
  145. #define STATUS_GEO_CONFIGURED 9
  146. #define STATUS_EXIT_PENDING 10
  147. #define STATUS_IN_SUSPEND 11
  148. #define STATUS_STATISTICS 12
  149. #define STATUS_SCANNING 13
  150. #define STATUS_SCAN_ABORTING 14
  151. #define STATUS_SCAN_HW 15
  152. #define STATUS_POWER_PMI 16
  153. #define STATUS_FW_ERROR 17
  154. #define STATUS_CONF_PENDING 18
  155. #define MAX_TID_COUNT 9
  156. #define IWL_INVALID_RATE 0xFF
  157. #define IWL_INVALID_VALUE -1
  158. #define STA_PS_STATUS_WAKE 0
  159. #define STA_PS_STATUS_SLEEP 1
  160. struct iwl3945_ibss_seq {
  161. u8 mac[ETH_ALEN];
  162. u16 seq_num;
  163. u16 frag_num;
  164. unsigned long packet_time;
  165. struct list_head list;
  166. };
  167. #define IWL_RX_HDR(x) ((struct iwl3945_rx_frame_hdr *)(\
  168. x->u.rx_frame.stats.payload + \
  169. x->u.rx_frame.stats.phy_count))
  170. #define IWL_RX_END(x) ((struct iwl3945_rx_frame_end *)(\
  171. IWL_RX_HDR(x)->payload + \
  172. le16_to_cpu(IWL_RX_HDR(x)->len)))
  173. #define IWL_RX_STATS(x) (&x->u.rx_frame.stats)
  174. #define IWL_RX_DATA(x) (IWL_RX_HDR(x)->payload)
  175. /******************************************************************************
  176. *
  177. * Functions implemented in iwl-base.c which are forward declared here
  178. * for use by iwl-*.c
  179. *
  180. *****************************************************************************/
  181. struct iwl3945_addsta_cmd;
  182. extern int iwl3945_send_add_station(struct iwl_priv *priv,
  183. struct iwl3945_addsta_cmd *sta, u8 flags);
  184. extern u8 iwl3945_add_station(struct iwl_priv *priv, const u8 *bssid,
  185. int is_ap, u8 flags);
  186. extern int iwl3945_power_init_handle(struct iwl_priv *priv);
  187. extern int iwl3945_eeprom_init(struct iwl_priv *priv);
  188. extern int iwl3945_rx_queue_alloc(struct iwl_priv *priv);
  189. extern void iwl3945_rx_queue_reset(struct iwl_priv *priv,
  190. struct iwl_rx_queue *rxq);
  191. extern int iwl3945_calc_db_from_ratio(int sig_ratio);
  192. extern int iwl3945_calc_sig_qual(int rssi_dbm, int noise_dbm);
  193. extern int iwl3945_tx_queue_init(struct iwl_priv *priv,
  194. struct iwl3945_tx_queue *txq, int count, u32 id);
  195. extern void iwl3945_rx_replenish(void *data);
  196. extern void iwl3945_tx_queue_free(struct iwl_priv *priv, struct iwl3945_tx_queue *txq);
  197. extern int iwl3945_send_cmd_pdu(struct iwl_priv *priv, u8 id, u16 len,
  198. const void *data);
  199. extern int __must_check iwl3945_send_cmd(struct iwl_priv *priv,
  200. struct iwl_host_cmd *cmd);
  201. extern unsigned int iwl3945_fill_beacon_frame(struct iwl_priv *priv,
  202. struct ieee80211_hdr *hdr,int left);
  203. extern int iwl3945_rx_queue_update_write_ptr(struct iwl_priv *priv,
  204. struct iwl_rx_queue *q);
  205. extern int iwl3945_send_statistics_request(struct iwl_priv *priv);
  206. extern void iwl3945_set_decrypted_flag(struct iwl_priv *priv, struct sk_buff *skb,
  207. u32 decrypt_res,
  208. struct ieee80211_rx_status *stats);
  209. /*
  210. * Currently used by iwl-3945-rs... look at restructuring so that it doesn't
  211. * call this... todo... fix that.
  212. */
  213. extern u8 iwl3945_sync_station(struct iwl_priv *priv, int sta_id,
  214. u16 tx_rate, u8 flags);
  215. /******************************************************************************
  216. *
  217. * Functions implemented in iwl-[34]*.c which are forward declared here
  218. * for use by iwl-base.c
  219. *
  220. * NOTE: The implementation of these functions are hardware specific
  221. * which is why they are in the hardware specific files (vs. iwl-base.c)
  222. *
  223. * Naming convention --
  224. * iwl3945_ <-- Its part of iwlwifi (should be changed to iwl3945_)
  225. * iwl3945_hw_ <-- Hardware specific (implemented in iwl-XXXX.c by all HW)
  226. * iwlXXXX_ <-- Hardware specific (implemented in iwl-XXXX.c for XXXX)
  227. * iwl3945_bg_ <-- Called from work queue context
  228. * iwl3945_mac_ <-- mac80211 callback
  229. *
  230. ****************************************************************************/
  231. extern void iwl3945_hw_rx_handler_setup(struct iwl_priv *priv);
  232. extern void iwl3945_hw_setup_deferred_work(struct iwl_priv *priv);
  233. extern void iwl3945_hw_cancel_deferred_work(struct iwl_priv *priv);
  234. extern int iwl3945_hw_rxq_stop(struct iwl_priv *priv);
  235. extern int iwl3945_hw_set_hw_params(struct iwl_priv *priv);
  236. extern int iwl3945_hw_nic_init(struct iwl_priv *priv);
  237. extern int iwl3945_hw_nic_stop_master(struct iwl_priv *priv);
  238. extern void iwl3945_hw_txq_ctx_free(struct iwl_priv *priv);
  239. extern void iwl3945_hw_txq_ctx_stop(struct iwl_priv *priv);
  240. extern int iwl3945_hw_nic_reset(struct iwl_priv *priv);
  241. extern int iwl3945_hw_txq_attach_buf_to_tfd(struct iwl_priv *priv, void *tfd,
  242. dma_addr_t addr, u16 len);
  243. extern int iwl3945_hw_txq_free_tfd(struct iwl_priv *priv, struct iwl3945_tx_queue *txq);
  244. extern int iwl3945_hw_get_temperature(struct iwl_priv *priv);
  245. extern int iwl3945_hw_tx_queue_init(struct iwl_priv *priv,
  246. struct iwl3945_tx_queue *txq);
  247. extern unsigned int iwl3945_hw_get_beacon_cmd(struct iwl_priv *priv,
  248. struct iwl3945_frame *frame, u8 rate);
  249. extern int iwl3945_hw_get_rx_read(struct iwl_priv *priv);
  250. void iwl3945_hw_build_tx_cmd_rate(struct iwl_priv *priv, struct iwl_cmd *cmd,
  251. struct ieee80211_tx_info *info,
  252. struct ieee80211_hdr *hdr,
  253. int sta_id, int tx_id);
  254. extern int iwl3945_hw_reg_send_txpower(struct iwl_priv *priv);
  255. extern int iwl3945_hw_reg_set_txpower(struct iwl_priv *priv, s8 power);
  256. extern void iwl3945_hw_rx_statistics(struct iwl_priv *priv,
  257. struct iwl_rx_mem_buffer *rxb);
  258. extern void iwl3945_disable_events(struct iwl_priv *priv);
  259. extern int iwl4965_get_temperature(const struct iwl_priv *priv);
  260. /**
  261. * iwl3945_hw_find_station - Find station id for a given BSSID
  262. * @bssid: MAC address of station ID to find
  263. *
  264. * NOTE: This should not be hardware specific but the code has
  265. * not yet been merged into a single common layer for managing the
  266. * station tables.
  267. */
  268. extern u8 iwl3945_hw_find_station(struct iwl_priv *priv, const u8 *bssid);
  269. extern int iwl3945_hw_channel_switch(struct iwl_priv *priv, u16 channel);
  270. /*
  271. * Forward declare iwl-3945.c functions for iwl-base.c
  272. */
  273. extern __le32 iwl3945_get_antenna_flags(const struct iwl_priv *priv);
  274. extern int iwl3945_init_hw_rate_table(struct iwl_priv *priv);
  275. extern void iwl3945_reg_txpower_periodic(struct iwl_priv *priv);
  276. extern int iwl3945_txpower_set_from_eeprom(struct iwl_priv *priv);
  277. extern u8 iwl3945_sync_sta(struct iwl_priv *priv, int sta_id,
  278. u16 tx_rate, u8 flags);
  279. #ifdef CONFIG_IWL3945_RFKILL
  280. struct iwl_priv;
  281. void iwl3945_rfkill_set_hw_state(struct iwl_priv *priv);
  282. void iwl3945_rfkill_unregister(struct iwl_priv *priv);
  283. int iwl3945_rfkill_init(struct iwl_priv *priv);
  284. #else
  285. static inline void iwl3945_rfkill_set_hw_state(struct iwl_priv *priv) {}
  286. static inline void iwl3945_rfkill_unregister(struct iwl_priv *priv) {}
  287. static inline int iwl3945_rfkill_init(struct iwl_priv *priv) { return 0; }
  288. #endif
  289. static inline int iwl3945_is_associated(struct iwl_priv *priv)
  290. {
  291. return (priv->active39_rxon.filter_flags & RXON_FILTER_ASSOC_MSK) ? 1 : 0;
  292. }
  293. extern const struct iwl_channel_info *iwl3945_get_channel_info(
  294. const struct iwl_priv *priv, enum ieee80211_band band, u16 channel);
  295. extern int iwl3945_rs_next_rate(struct iwl_priv *priv, int rate);
  296. /* Requires full declaration of iwl_priv before including */
  297. #include "iwl-io.h"
  298. #endif