iwl-3945.h 14 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402
  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 int iwl3945_param_hwcrypto;
  69. extern int iwl3945_param_queues_num;
  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 IWL_RX_BUF_SIZE 3000U
  87. #define DEFAULT_RTS_THRESHOLD 2347U
  88. #define MIN_RTS_THRESHOLD 0U
  89. #define MAX_RTS_THRESHOLD 2347U
  90. #define MAX_MSDU_SIZE 2304U
  91. #define MAX_MPDU_SIZE 2346U
  92. #define DEFAULT_BEACON_INTERVAL 100U
  93. #define DEFAULT_SHORT_RETRY_LIMIT 7U
  94. #define DEFAULT_LONG_RETRY_LIMIT 4U
  95. int iwl3945_x2_queue_used(const struct iwl_queue *q, int i);
  96. #define MAX_NUM_OF_TBS (20)
  97. /* One for each TFD */
  98. struct iwl3945_tx_info {
  99. struct sk_buff *skb[MAX_NUM_OF_TBS];
  100. };
  101. #include "iwl-agn-rs.h"
  102. #define IWL_TX_FIFO_AC0 0
  103. #define IWL_TX_FIFO_AC1 1
  104. #define IWL_TX_FIFO_AC2 2
  105. #define IWL_TX_FIFO_AC3 3
  106. #define IWL_TX_FIFO_HCCA_1 5
  107. #define IWL_TX_FIFO_HCCA_2 6
  108. #define IWL_TX_FIFO_NONE 7
  109. /* Minimum number of queues. MAX_NUM is defined in hw specific files */
  110. #define IWL_MIN_NUM_QUEUES 4
  111. #define IEEE80211_DATA_LEN 2304
  112. #define IEEE80211_4ADDR_LEN 30
  113. #define IEEE80211_HLEN (IEEE80211_4ADDR_LEN)
  114. #define IEEE80211_FRAME_LEN (IEEE80211_DATA_LEN + IEEE80211_HLEN)
  115. struct iwl3945_frame {
  116. union {
  117. struct ieee80211_hdr frame;
  118. struct iwl3945_tx_beacon_cmd beacon;
  119. u8 raw[IEEE80211_FRAME_LEN];
  120. u8 cmd[360];
  121. } u;
  122. struct list_head list;
  123. };
  124. #define SEQ_TO_SN(seq) (((seq) & IEEE80211_SCTL_SEQ) >> 4)
  125. #define SN_TO_SEQ(ssn) (((ssn) << 4) & IEEE80211_SCTL_SEQ)
  126. #define MAX_SN ((IEEE80211_SCTL_SEQ) >> 4)
  127. struct iwl3945_cmd;
  128. struct iwl_priv;
  129. struct iwl3945_cmd_meta {
  130. struct iwl3945_cmd_meta *source;
  131. union {
  132. struct sk_buff *skb;
  133. int (*callback)(struct iwl_priv *priv,
  134. struct iwl3945_cmd *cmd, struct sk_buff *skb);
  135. } __attribute__ ((packed)) u;
  136. /* The CMD_SIZE_HUGE flag bit indicates that the command
  137. * structure is stored at the end of the shared queue memory. */
  138. u32 flags;
  139. } __attribute__ ((packed));
  140. /**
  141. * struct iwl3945_cmd
  142. *
  143. * For allocation of the command and tx queues, this establishes the overall
  144. * size of the largest command we send to uCode, except for a scan command
  145. * (which is relatively huge; space is allocated separately).
  146. */
  147. struct iwl3945_cmd {
  148. struct iwl3945_cmd_meta meta;
  149. struct iwl_cmd_header hdr;
  150. union {
  151. struct iwl3945_addsta_cmd addsta;
  152. struct iwl_led_cmd led;
  153. u32 flags;
  154. u8 val8;
  155. u16 val16;
  156. u32 val32;
  157. struct iwl_bt_cmd bt;
  158. struct iwl_rxon_time_cmd rxon_time;
  159. struct iwl_powertable_cmd powertable;
  160. struct iwl_qosparam_cmd qosparam;
  161. struct iwl3945_tx_cmd tx;
  162. struct iwl3945_tx_beacon_cmd tx_beacon;
  163. struct iwl3945_rxon_assoc_cmd rxon_assoc;
  164. u8 *indirect;
  165. u8 payload[360];
  166. } __attribute__ ((packed)) cmd;
  167. } __attribute__ ((packed));
  168. struct iwl3945_host_cmd {
  169. u8 id;
  170. u16 len;
  171. struct iwl3945_cmd_meta meta;
  172. const void *data;
  173. };
  174. #define TFD39_MAX_PAYLOAD_SIZE (sizeof(struct iwl3945_cmd) - \
  175. sizeof(struct iwl3945_cmd_meta))
  176. /*
  177. * RX related structures and functions
  178. */
  179. #define RX_FREE_BUFFERS 64
  180. #define RX_LOW_WATERMARK 8
  181. #define SUP_RATE_11A_MAX_NUM_CHANNELS 8
  182. #define SUP_RATE_11B_MAX_NUM_CHANNELS 4
  183. #define SUP_RATE_11G_MAX_NUM_CHANNELS 12
  184. #define IWL_SUPPORTED_RATES_IE_LEN 8
  185. #define SCAN_INTERVAL 100
  186. #define STATUS_HCMD_ACTIVE 0 /* host command in progress */
  187. #define STATUS_HCMD_SYNC_ACTIVE 1 /* sync host command in progress */
  188. #define STATUS_INT_ENABLED 2
  189. #define STATUS_RF_KILL_HW 3
  190. #define STATUS_RF_KILL_SW 4
  191. #define STATUS_INIT 5
  192. #define STATUS_ALIVE 6
  193. #define STATUS_READY 7
  194. #define STATUS_TEMPERATURE 8
  195. #define STATUS_GEO_CONFIGURED 9
  196. #define STATUS_EXIT_PENDING 10
  197. #define STATUS_IN_SUSPEND 11
  198. #define STATUS_STATISTICS 12
  199. #define STATUS_SCANNING 13
  200. #define STATUS_SCAN_ABORTING 14
  201. #define STATUS_SCAN_HW 15
  202. #define STATUS_POWER_PMI 16
  203. #define STATUS_FW_ERROR 17
  204. #define STATUS_CONF_PENDING 18
  205. #define MAX_TID_COUNT 9
  206. #define IWL_INVALID_RATE 0xFF
  207. #define IWL_INVALID_VALUE -1
  208. #define STA_PS_STATUS_WAKE 0
  209. #define STA_PS_STATUS_SLEEP 1
  210. struct iwl3945_ibss_seq {
  211. u8 mac[ETH_ALEN];
  212. u16 seq_num;
  213. u16 frag_num;
  214. unsigned long packet_time;
  215. struct list_head list;
  216. };
  217. #define IWL_RX_HDR(x) ((struct iwl3945_rx_frame_hdr *)(\
  218. x->u.rx_frame.stats.payload + \
  219. x->u.rx_frame.stats.phy_count))
  220. #define IWL_RX_END(x) ((struct iwl3945_rx_frame_end *)(\
  221. IWL_RX_HDR(x)->payload + \
  222. le16_to_cpu(IWL_RX_HDR(x)->len)))
  223. #define IWL_RX_STATS(x) (&x->u.rx_frame.stats)
  224. #define IWL_RX_DATA(x) (IWL_RX_HDR(x)->payload)
  225. /******************************************************************************
  226. *
  227. * Functions implemented in iwl-base.c which are forward declared here
  228. * for use by iwl-*.c
  229. *
  230. *****************************************************************************/
  231. struct iwl3945_addsta_cmd;
  232. extern int iwl3945_send_add_station(struct iwl_priv *priv,
  233. struct iwl3945_addsta_cmd *sta, u8 flags);
  234. extern u8 iwl3945_add_station(struct iwl_priv *priv, const u8 *bssid,
  235. int is_ap, u8 flags);
  236. extern int iwl3945_power_init_handle(struct iwl_priv *priv);
  237. extern int iwl3945_eeprom_init(struct iwl_priv *priv);
  238. extern int iwl3945_rx_queue_alloc(struct iwl_priv *priv);
  239. extern void iwl3945_rx_queue_reset(struct iwl_priv *priv,
  240. struct iwl_rx_queue *rxq);
  241. extern int iwl3945_calc_db_from_ratio(int sig_ratio);
  242. extern int iwl3945_calc_sig_qual(int rssi_dbm, int noise_dbm);
  243. extern int iwl3945_tx_queue_init(struct iwl_priv *priv,
  244. struct iwl3945_tx_queue *txq, int count, u32 id);
  245. extern void iwl3945_rx_replenish(void *data);
  246. extern void iwl3945_tx_queue_free(struct iwl_priv *priv, struct iwl3945_tx_queue *txq);
  247. extern int iwl3945_send_cmd_pdu(struct iwl_priv *priv, u8 id, u16 len,
  248. const void *data);
  249. extern int __must_check iwl3945_send_cmd(struct iwl_priv *priv,
  250. struct iwl3945_host_cmd *cmd);
  251. extern unsigned int iwl3945_fill_beacon_frame(struct iwl_priv *priv,
  252. struct ieee80211_hdr *hdr,int left);
  253. extern int iwl3945_rx_queue_update_write_ptr(struct iwl_priv *priv,
  254. struct iwl_rx_queue *q);
  255. extern int iwl3945_send_statistics_request(struct iwl_priv *priv);
  256. extern void iwl3945_set_decrypted_flag(struct iwl_priv *priv, struct sk_buff *skb,
  257. u32 decrypt_res,
  258. struct ieee80211_rx_status *stats);
  259. /*
  260. * Currently used by iwl-3945-rs... look at restructuring so that it doesn't
  261. * call this... todo... fix that.
  262. */
  263. extern u8 iwl3945_sync_station(struct iwl_priv *priv, int sta_id,
  264. u16 tx_rate, u8 flags);
  265. /******************************************************************************
  266. *
  267. * Functions implemented in iwl-[34]*.c which are forward declared here
  268. * for use by iwl-base.c
  269. *
  270. * NOTE: The implementation of these functions are hardware specific
  271. * which is why they are in the hardware specific files (vs. iwl-base.c)
  272. *
  273. * Naming convention --
  274. * iwl3945_ <-- Its part of iwlwifi (should be changed to iwl3945_)
  275. * iwl3945_hw_ <-- Hardware specific (implemented in iwl-XXXX.c by all HW)
  276. * iwlXXXX_ <-- Hardware specific (implemented in iwl-XXXX.c for XXXX)
  277. * iwl3945_bg_ <-- Called from work queue context
  278. * iwl3945_mac_ <-- mac80211 callback
  279. *
  280. ****************************************************************************/
  281. extern void iwl3945_hw_rx_handler_setup(struct iwl_priv *priv);
  282. extern void iwl3945_hw_setup_deferred_work(struct iwl_priv *priv);
  283. extern void iwl3945_hw_cancel_deferred_work(struct iwl_priv *priv);
  284. extern int iwl3945_hw_rxq_stop(struct iwl_priv *priv);
  285. extern int iwl3945_hw_set_hw_params(struct iwl_priv *priv);
  286. extern int iwl3945_hw_nic_init(struct iwl_priv *priv);
  287. extern int iwl3945_hw_nic_stop_master(struct iwl_priv *priv);
  288. extern void iwl3945_hw_txq_ctx_free(struct iwl_priv *priv);
  289. extern void iwl3945_hw_txq_ctx_stop(struct iwl_priv *priv);
  290. extern int iwl3945_hw_nic_reset(struct iwl_priv *priv);
  291. extern int iwl3945_hw_txq_attach_buf_to_tfd(struct iwl_priv *priv, void *tfd,
  292. dma_addr_t addr, u16 len);
  293. extern int iwl3945_hw_txq_free_tfd(struct iwl_priv *priv, struct iwl3945_tx_queue *txq);
  294. extern int iwl3945_hw_get_temperature(struct iwl_priv *priv);
  295. extern int iwl3945_hw_tx_queue_init(struct iwl_priv *priv,
  296. struct iwl3945_tx_queue *txq);
  297. extern unsigned int iwl3945_hw_get_beacon_cmd(struct iwl_priv *priv,
  298. struct iwl3945_frame *frame, u8 rate);
  299. extern int iwl3945_hw_get_rx_read(struct iwl_priv *priv);
  300. extern void iwl3945_hw_build_tx_cmd_rate(struct iwl_priv *priv,
  301. struct iwl3945_cmd *cmd,
  302. struct ieee80211_tx_info *info,
  303. struct ieee80211_hdr *hdr,
  304. int sta_id, int tx_id);
  305. extern int iwl3945_hw_reg_send_txpower(struct iwl_priv *priv);
  306. extern int iwl3945_hw_reg_set_txpower(struct iwl_priv *priv, s8 power);
  307. extern void iwl3945_hw_rx_statistics(struct iwl_priv *priv,
  308. struct iwl_rx_mem_buffer *rxb);
  309. extern void iwl3945_disable_events(struct iwl_priv *priv);
  310. extern int iwl4965_get_temperature(const struct iwl_priv *priv);
  311. /**
  312. * iwl3945_hw_find_station - Find station id for a given BSSID
  313. * @bssid: MAC address of station ID to find
  314. *
  315. * NOTE: This should not be hardware specific but the code has
  316. * not yet been merged into a single common layer for managing the
  317. * station tables.
  318. */
  319. extern u8 iwl3945_hw_find_station(struct iwl_priv *priv, const u8 *bssid);
  320. extern int iwl3945_hw_channel_switch(struct iwl_priv *priv, u16 channel);
  321. /*
  322. * Forward declare iwl-3945.c functions for iwl-base.c
  323. */
  324. extern __le32 iwl3945_get_antenna_flags(const struct iwl_priv *priv);
  325. extern int iwl3945_init_hw_rate_table(struct iwl_priv *priv);
  326. extern void iwl3945_reg_txpower_periodic(struct iwl_priv *priv);
  327. extern int iwl3945_txpower_set_from_eeprom(struct iwl_priv *priv);
  328. extern u8 iwl3945_sync_sta(struct iwl_priv *priv, int sta_id,
  329. u16 tx_rate, u8 flags);
  330. #ifdef CONFIG_IWL3945_RFKILL
  331. struct iwl_priv;
  332. void iwl3945_rfkill_set_hw_state(struct iwl_priv *priv);
  333. void iwl3945_rfkill_unregister(struct iwl_priv *priv);
  334. int iwl3945_rfkill_init(struct iwl_priv *priv);
  335. #else
  336. static inline void iwl3945_rfkill_set_hw_state(struct iwl_priv *priv) {}
  337. static inline void iwl3945_rfkill_unregister(struct iwl_priv *priv) {}
  338. static inline int iwl3945_rfkill_init(struct iwl_priv *priv) { return 0; }
  339. #endif
  340. static inline int iwl3945_is_associated(struct iwl_priv *priv)
  341. {
  342. return (priv->active39_rxon.filter_flags & RXON_FILTER_ASSOC_MSK) ? 1 : 0;
  343. }
  344. extern const struct iwl_channel_info *iwl3945_get_channel_info(
  345. const struct iwl_priv *priv, enum ieee80211_band band, u16 channel);
  346. extern int iwl3945_rs_next_rate(struct iwl_priv *priv, int rate);
  347. /* Requires full declaration of iwl_priv before including */
  348. #include "iwl-io.h"
  349. #endif