1 /******************************************************************************
3 * Copyright(c) 2003 - 2008 Intel Corporation. All rights reserved.
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.
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
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
18 * The full GNU General Public License is included in this distribution in the
19 * file called LICENSE.
21 * Contact Information:
22 * Intel Linux Wireless <ilw@linux.intel.com>
23 * Intel Corporation, 5200 N.E. Elam Young Parkway, Hillsboro, OR 97124-6497
25 *****************************************************************************/
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.
32 #ifndef __iwl_3945_h__
33 #define __iwl_3945_h__
35 #include <linux/pci.h> /* for struct pci_device_id */
36 #include <linux/kernel.h>
37 #include <net/ieee80211_radiotap.h>
40 #include <linux/rfkill.h>
41 #include <linux/input.h>
43 /* Hardware specific file defines the PCI IDs table for that hardware module */
44 extern struct pci_device_id iwl3945_hw_card_ids[];
48 #include "iwl-3945-hw.h"
49 #include "iwl-debug.h"
50 #include "iwl-power.h"
52 #include "iwl-3945-led.h"
54 /* Highest firmware API version supported */
55 #define IWL3945_UCODE_API_MAX 2
57 /* Lowest firmware API version supported */
58 #define IWL3945_UCODE_API_MIN 1
60 #define IWL3945_FW_PRE "iwlwifi-3945-"
61 #define _IWL3945_MODULE_FIRMWARE(api) IWL3945_FW_PRE #api ".ucode"
62 #define IWL3945_MODULE_FIRMWARE(api) _IWL3945_MODULE_FIRMWARE(api)
64 /* Default noise level to report when noise measurement is not available.
65 * This may be because we're:
66 * 1) Not associated (4965, no beacon statistics being sent to driver)
67 * 2) Scanning (noise measurement does not apply to associated channel)
68 * 3) Receiving CCK (3945 delivers noise info only for OFDM frames)
69 * Use default noise value of -127 ... this is below the range of measurable
70 * Rx dBm for either 3945 or 4965, so it can indicate "unmeasurable" to user.
71 * Also, -127 works better than 0 when averaging frames with/without
72 * noise info (e.g. averaging might be done in app); measured dBm values are
73 * always negative ... using a negative value as the default keeps all
74 * averages within an s8's (used in some apps) range of negative values. */
75 #define IWL_NOISE_MEAS_NOT_AVAILABLE (-127)
77 /* Module parameters accessible from iwl-*.c */
78 extern struct iwl_mod_params iwl3945_mod_params;
80 struct iwl3945_sta_priv {
81 struct iwl3945_rs_sta *rs_sta;
84 enum iwl3945_antenna {
85 IWL_ANTENNA_DIVERSITY,
91 * RTS threshold here is total size [2347] minus 4 FCS bytes
93 * a value of 0 means RTS on all data/management packets
94 * a value > max MSDU size means no RTS
95 * else RTS for data/management frames where MPDU is larger
98 #define IWL_RX_BUF_SIZE 3000U
99 #define DEFAULT_RTS_THRESHOLD 2347U
100 #define MIN_RTS_THRESHOLD 0U
101 #define MAX_RTS_THRESHOLD 2347U
102 #define MAX_MSDU_SIZE 2304U
103 #define MAX_MPDU_SIZE 2346U
104 #define DEFAULT_BEACON_INTERVAL 100U
105 #define DEFAULT_SHORT_RETRY_LIMIT 7U
106 #define DEFAULT_LONG_RETRY_LIMIT 4U
108 int iwl3945_x2_queue_used(const struct iwl_queue *q, int i);
110 #define MAX_NUM_OF_TBS (20)
112 /* One for each TFD */
113 struct iwl3945_tx_info {
114 struct sk_buff *skb[MAX_NUM_OF_TBS];
117 #include "iwl-agn-rs.h"
119 #define IWL_TX_FIFO_AC0 0
120 #define IWL_TX_FIFO_AC1 1
121 #define IWL_TX_FIFO_AC2 2
122 #define IWL_TX_FIFO_AC3 3
123 #define IWL_TX_FIFO_HCCA_1 5
124 #define IWL_TX_FIFO_HCCA_2 6
125 #define IWL_TX_FIFO_NONE 7
127 /* Minimum number of queues. MAX_NUM is defined in hw specific files */
128 #define IWL_MIN_NUM_QUEUES 4
130 #define IEEE80211_DATA_LEN 2304
131 #define IEEE80211_4ADDR_LEN 30
132 #define IEEE80211_HLEN (IEEE80211_4ADDR_LEN)
133 #define IEEE80211_FRAME_LEN (IEEE80211_DATA_LEN + IEEE80211_HLEN)
135 struct iwl3945_frame {
137 struct ieee80211_hdr frame;
138 struct iwl3945_tx_beacon_cmd beacon;
139 u8 raw[IEEE80211_FRAME_LEN];
142 struct list_head list;
145 #define SEQ_TO_SN(seq) (((seq) & IEEE80211_SCTL_SEQ) >> 4)
146 #define SN_TO_SEQ(ssn) (((ssn) << 4) & IEEE80211_SCTL_SEQ)
147 #define MAX_SN ((IEEE80211_SCTL_SEQ) >> 4)
150 * RX related structures and functions
152 #define RX_FREE_BUFFERS 64
153 #define RX_LOW_WATERMARK 8
155 #define SUP_RATE_11A_MAX_NUM_CHANNELS 8
156 #define SUP_RATE_11B_MAX_NUM_CHANNELS 4
157 #define SUP_RATE_11G_MAX_NUM_CHANNELS 12
159 #define IWL_SUPPORTED_RATES_IE_LEN 8
161 #define SCAN_INTERVAL 100
163 #define STATUS_HCMD_ACTIVE 0 /* host command in progress */
164 #define STATUS_HCMD_SYNC_ACTIVE 1 /* sync host command in progress */
165 #define STATUS_INT_ENABLED 2
166 #define STATUS_RF_KILL_HW 3
167 #define STATUS_RF_KILL_SW 4
168 #define STATUS_INIT 5
169 #define STATUS_ALIVE 6
170 #define STATUS_READY 7
171 #define STATUS_TEMPERATURE 8
172 #define STATUS_GEO_CONFIGURED 9
173 #define STATUS_EXIT_PENDING 10
174 #define STATUS_IN_SUSPEND 11
175 #define STATUS_STATISTICS 12
176 #define STATUS_SCANNING 13
177 #define STATUS_SCAN_ABORTING 14
178 #define STATUS_SCAN_HW 15
179 #define STATUS_POWER_PMI 16
180 #define STATUS_FW_ERROR 17
181 #define STATUS_CONF_PENDING 18
183 #define MAX_TID_COUNT 9
185 #define IWL_INVALID_RATE 0xFF
186 #define IWL_INVALID_VALUE -1
188 #define STA_PS_STATUS_WAKE 0
189 #define STA_PS_STATUS_SLEEP 1
191 struct iwl3945_ibss_seq {
195 unsigned long packet_time;
196 struct list_head list;
199 #define IWL_RX_HDR(x) ((struct iwl3945_rx_frame_hdr *)(\
200 x->u.rx_frame.stats.payload + \
201 x->u.rx_frame.stats.phy_count))
202 #define IWL_RX_END(x) ((struct iwl3945_rx_frame_end *)(\
203 IWL_RX_HDR(x)->payload + \
204 le16_to_cpu(IWL_RX_HDR(x)->len)))
205 #define IWL_RX_STATS(x) (&x->u.rx_frame.stats)
206 #define IWL_RX_DATA(x) (IWL_RX_HDR(x)->payload)
209 /******************************************************************************
211 * Functions implemented in iwl-base.c which are forward declared here
214 *****************************************************************************/
215 struct iwl3945_addsta_cmd;
216 extern int iwl3945_send_add_station(struct iwl_priv *priv,
217 struct iwl3945_addsta_cmd *sta, u8 flags);
218 extern u8 iwl3945_add_station(struct iwl_priv *priv, const u8 *bssid,
219 int is_ap, u8 flags);
220 extern int iwl3945_power_init_handle(struct iwl_priv *priv);
221 extern int iwl3945_eeprom_init(struct iwl_priv *priv);
222 extern int iwl3945_rx_queue_alloc(struct iwl_priv *priv);
223 extern void iwl3945_rx_queue_reset(struct iwl_priv *priv,
224 struct iwl_rx_queue *rxq);
225 extern int iwl3945_calc_db_from_ratio(int sig_ratio);
226 extern int iwl3945_calc_sig_qual(int rssi_dbm, int noise_dbm);
227 extern int iwl3945_tx_queue_init(struct iwl_priv *priv,
228 struct iwl3945_tx_queue *txq, int count, u32 id);
229 extern void iwl3945_rx_replenish(void *data);
230 extern void iwl3945_tx_queue_free(struct iwl_priv *priv, struct iwl3945_tx_queue *txq);
231 extern int iwl3945_send_cmd_pdu(struct iwl_priv *priv, u8 id, u16 len,
233 extern int __must_check iwl3945_send_cmd(struct iwl_priv *priv,
234 struct iwl_host_cmd *cmd);
235 extern unsigned int iwl3945_fill_beacon_frame(struct iwl_priv *priv,
236 struct ieee80211_hdr *hdr,int left);
237 extern int iwl3945_rx_queue_update_write_ptr(struct iwl_priv *priv,
238 struct iwl_rx_queue *q);
239 extern int iwl3945_send_statistics_request(struct iwl_priv *priv);
240 extern void iwl3945_set_decrypted_flag(struct iwl_priv *priv, struct sk_buff *skb,
242 struct ieee80211_rx_status *stats);
245 * Currently used by iwl-3945-rs... look at restructuring so that it doesn't
246 * call this... todo... fix that.
248 extern u8 iwl3945_sync_station(struct iwl_priv *priv, int sta_id,
249 u16 tx_rate, u8 flags);
251 /******************************************************************************
253 * Functions implemented in iwl-[34]*.c which are forward declared here
254 * for use by iwl-base.c
256 * NOTE: The implementation of these functions are hardware specific
257 * which is why they are in the hardware specific files (vs. iwl-base.c)
259 * Naming convention --
260 * iwl3945_ <-- Its part of iwlwifi (should be changed to iwl3945_)
261 * iwl3945_hw_ <-- Hardware specific (implemented in iwl-XXXX.c by all HW)
262 * iwlXXXX_ <-- Hardware specific (implemented in iwl-XXXX.c for XXXX)
263 * iwl3945_bg_ <-- Called from work queue context
264 * iwl3945_mac_ <-- mac80211 callback
266 ****************************************************************************/
267 extern void iwl3945_hw_rx_handler_setup(struct iwl_priv *priv);
268 extern void iwl3945_hw_setup_deferred_work(struct iwl_priv *priv);
269 extern void iwl3945_hw_cancel_deferred_work(struct iwl_priv *priv);
270 extern int iwl3945_hw_rxq_stop(struct iwl_priv *priv);
271 extern int iwl3945_hw_set_hw_params(struct iwl_priv *priv);
272 extern int iwl3945_hw_nic_init(struct iwl_priv *priv);
273 extern int iwl3945_hw_nic_stop_master(struct iwl_priv *priv);
274 extern void iwl3945_hw_txq_ctx_free(struct iwl_priv *priv);
275 extern void iwl3945_hw_txq_ctx_stop(struct iwl_priv *priv);
276 extern int iwl3945_hw_nic_reset(struct iwl_priv *priv);
277 extern int iwl3945_hw_txq_attach_buf_to_tfd(struct iwl_priv *priv, void *tfd,
278 dma_addr_t addr, u16 len);
279 extern int iwl3945_hw_txq_free_tfd(struct iwl_priv *priv, struct iwl3945_tx_queue *txq);
280 extern int iwl3945_hw_get_temperature(struct iwl_priv *priv);
281 extern int iwl3945_hw_tx_queue_init(struct iwl_priv *priv,
282 struct iwl3945_tx_queue *txq);
283 extern unsigned int iwl3945_hw_get_beacon_cmd(struct iwl_priv *priv,
284 struct iwl3945_frame *frame, u8 rate);
285 void iwl3945_hw_build_tx_cmd_rate(struct iwl_priv *priv, struct iwl_cmd *cmd,
286 struct ieee80211_tx_info *info,
287 struct ieee80211_hdr *hdr,
288 int sta_id, int tx_id);
289 extern int iwl3945_hw_reg_send_txpower(struct iwl_priv *priv);
290 extern int iwl3945_hw_reg_set_txpower(struct iwl_priv *priv, s8 power);
291 extern void iwl3945_hw_rx_statistics(struct iwl_priv *priv,
292 struct iwl_rx_mem_buffer *rxb);
293 extern void iwl3945_disable_events(struct iwl_priv *priv);
294 extern int iwl4965_get_temperature(const struct iwl_priv *priv);
297 * iwl3945_hw_find_station - Find station id for a given BSSID
298 * @bssid: MAC address of station ID to find
300 * NOTE: This should not be hardware specific but the code has
301 * not yet been merged into a single common layer for managing the
304 extern u8 iwl3945_hw_find_station(struct iwl_priv *priv, const u8 *bssid);
306 extern int iwl3945_hw_channel_switch(struct iwl_priv *priv, u16 channel);
309 * Forward declare iwl-3945.c functions for iwl-base.c
311 extern __le32 iwl3945_get_antenna_flags(const struct iwl_priv *priv);
312 extern int iwl3945_init_hw_rate_table(struct iwl_priv *priv);
313 extern void iwl3945_reg_txpower_periodic(struct iwl_priv *priv);
314 extern int iwl3945_txpower_set_from_eeprom(struct iwl_priv *priv);
315 extern u8 iwl3945_sync_sta(struct iwl_priv *priv, int sta_id,
316 u16 tx_rate, u8 flags);
318 #ifdef CONFIG_IWL3945_RFKILL
321 void iwl3945_rfkill_set_hw_state(struct iwl_priv *priv);
322 void iwl3945_rfkill_unregister(struct iwl_priv *priv);
323 int iwl3945_rfkill_init(struct iwl_priv *priv);
325 static inline void iwl3945_rfkill_set_hw_state(struct iwl_priv *priv) {}
326 static inline void iwl3945_rfkill_unregister(struct iwl_priv *priv) {}
327 static inline int iwl3945_rfkill_init(struct iwl_priv *priv) { return 0; }
330 static inline int iwl3945_is_associated(struct iwl_priv *priv)
332 return (priv->active39_rxon.filter_flags & RXON_FILTER_ASSOC_MSK) ? 1 : 0;
335 extern const struct iwl_channel_info *iwl3945_get_channel_info(
336 const struct iwl_priv *priv, enum ieee80211_band band, u16 channel);
338 extern int iwl3945_rs_next_rate(struct iwl_priv *priv, int rate);
340 /* Requires full declaration of iwl_priv before including */