iwl-3945.h 11 KB

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