Linux Audio

Check our new training course

Loading...
Note: File does not exist in v5.4.
  1/******************************************************************************
  2 *
  3 * Copyright(c) 2003 - 2011 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
 32#ifndef __iwl_3945_h__
 33#define __iwl_3945_h__
 34
 35#include <linux/pci.h> /* for struct pci_device_id */
 36#include <linux/kernel.h>
 37#include <net/ieee80211_radiotap.h>
 38
 39/* Hardware specific file defines the PCI IDs table for that hardware module */
 40extern const struct pci_device_id iwl3945_hw_card_ids[];
 41
 42#include "iwl-csr.h"
 43#include "iwl-prph.h"
 44#include "iwl-fh.h"
 45#include "iwl-3945-hw.h"
 46#include "iwl-debug.h"
 47#include "iwl-power.h"
 48#include "iwl-dev.h"
 49#include "iwl-led.h"
 50
 51/* Highest firmware API version supported */
 52#define IWL3945_UCODE_API_MAX 2
 53
 54/* Lowest firmware API version supported */
 55#define IWL3945_UCODE_API_MIN 1
 56
 57#define IWL3945_FW_PRE	"iwlwifi-3945-"
 58#define _IWL3945_MODULE_FIRMWARE(api) IWL3945_FW_PRE #api ".ucode"
 59#define IWL3945_MODULE_FIRMWARE(api) _IWL3945_MODULE_FIRMWARE(api)
 60
 61/* Default noise level to report when noise measurement is not available.
 62 *   This may be because we're:
 63 *   1)  Not associated (4965, no beacon statistics being sent to driver)
 64 *   2)  Scanning (noise measurement does not apply to associated channel)
 65 *   3)  Receiving CCK (3945 delivers noise info only for OFDM frames)
 66 * Use default noise value of -127 ... this is below the range of measurable
 67 *   Rx dBm for either 3945 or 4965, so it can indicate "unmeasurable" to user.
 68 *   Also, -127 works better than 0 when averaging frames with/without
 69 *   noise info (e.g. averaging might be done in app); measured dBm values are
 70 *   always negative ... using a negative value as the default keeps all
 71 *   averages within an s8's (used in some apps) range of negative values. */
 72#define IWL_NOISE_MEAS_NOT_AVAILABLE (-127)
 73
 74/* Module parameters accessible from iwl-*.c */
 75extern struct iwl_mod_params iwl3945_mod_params;
 76
 77struct iwl3945_rate_scale_data {
 78	u64 data;
 79	s32 success_counter;
 80	s32 success_ratio;
 81	s32 counter;
 82	s32 average_tpt;
 83	unsigned long stamp;
 84};
 85
 86struct iwl3945_rs_sta {
 87	spinlock_t lock;
 88	struct iwl_priv *priv;
 89	s32 *expected_tpt;
 90	unsigned long last_partial_flush;
 91	unsigned long last_flush;
 92	u32 flush_time;
 93	u32 last_tx_packets;
 94	u32 tx_packets;
 95	u8 tgg;
 96	u8 flush_pending;
 97	u8 start_rate;
 98	struct timer_list rate_scale_flush;
 99	struct iwl3945_rate_scale_data win[IWL_RATE_COUNT_3945];
100#ifdef CONFIG_MAC80211_DEBUGFS
101	struct dentry *rs_sta_dbgfs_stats_table_file;
102#endif
103
104	/* used to be in sta_info */
105	int last_txrate_idx;
106};
107
108
109/*
110 * The common struct MUST be first because it is shared between
111 * 3945 and 4965!
112 */
113struct iwl3945_sta_priv {
114	struct iwl_station_priv_common common;
115	struct iwl3945_rs_sta rs_sta;
116};
117
118enum iwl3945_antenna {
119	IWL_ANTENNA_DIVERSITY,
120	IWL_ANTENNA_MAIN,
121	IWL_ANTENNA_AUX
122};
123
124/*
125 * RTS threshold here is total size [2347] minus 4 FCS bytes
126 * Per spec:
127 *   a value of 0 means RTS on all data/management packets
128 *   a value > max MSDU size means no RTS
129 * else RTS for data/management frames where MPDU is larger
130 *   than RTS value.
131 */
132#define DEFAULT_RTS_THRESHOLD     2347U
133#define MIN_RTS_THRESHOLD         0U
134#define MAX_RTS_THRESHOLD         2347U
135#define MAX_MSDU_SIZE		  2304U
136#define MAX_MPDU_SIZE		  2346U
137#define DEFAULT_BEACON_INTERVAL   100U
138#define	DEFAULT_SHORT_RETRY_LIMIT 7U
139#define	DEFAULT_LONG_RETRY_LIMIT  4U
140
141#define IWL_TX_FIFO_AC0	0
142#define IWL_TX_FIFO_AC1	1
143#define IWL_TX_FIFO_AC2	2
144#define IWL_TX_FIFO_AC3	3
145#define IWL_TX_FIFO_HCCA_1	5
146#define IWL_TX_FIFO_HCCA_2	6
147#define IWL_TX_FIFO_NONE	7
148
149#define IEEE80211_DATA_LEN              2304
150#define IEEE80211_4ADDR_LEN             30
151#define IEEE80211_HLEN                  (IEEE80211_4ADDR_LEN)
152#define IEEE80211_FRAME_LEN             (IEEE80211_DATA_LEN + IEEE80211_HLEN)
153
154struct iwl3945_frame {
155	union {
156		struct ieee80211_hdr frame;
157		struct iwl3945_tx_beacon_cmd beacon;
158		u8 raw[IEEE80211_FRAME_LEN];
159		u8 cmd[360];
160	} u;
161	struct list_head list;
162};
163
164#define SEQ_TO_SN(seq) (((seq) & IEEE80211_SCTL_SEQ) >> 4)
165#define SN_TO_SEQ(ssn) (((ssn) << 4) & IEEE80211_SCTL_SEQ)
166#define MAX_SN ((IEEE80211_SCTL_SEQ) >> 4)
167
168#define SUP_RATE_11A_MAX_NUM_CHANNELS  8
169#define SUP_RATE_11B_MAX_NUM_CHANNELS  4
170#define SUP_RATE_11G_MAX_NUM_CHANNELS  12
171
172#define IWL_SUPPORTED_RATES_IE_LEN         8
173
174#define SCAN_INTERVAL 100
175
176#define MAX_TID_COUNT        9
177
178#define IWL_INVALID_RATE     0xFF
179#define IWL_INVALID_VALUE    -1
180
181#define STA_PS_STATUS_WAKE             0
182#define STA_PS_STATUS_SLEEP            1
183
184struct iwl3945_ibss_seq {
185	u8 mac[ETH_ALEN];
186	u16 seq_num;
187	u16 frag_num;
188	unsigned long packet_time;
189	struct list_head list;
190};
191
192#define IWL_RX_HDR(x) ((struct iwl3945_rx_frame_hdr *)(\
193		       x->u.rx_frame.stats.payload + \
194		       x->u.rx_frame.stats.phy_count))
195#define IWL_RX_END(x) ((struct iwl3945_rx_frame_end *)(\
196		       IWL_RX_HDR(x)->payload + \
197		       le16_to_cpu(IWL_RX_HDR(x)->len)))
198#define IWL_RX_STATS(x) (&x->u.rx_frame.stats)
199#define IWL_RX_DATA(x) (IWL_RX_HDR(x)->payload)
200
201
202/******************************************************************************
203 *
204 * Functions implemented in iwl3945-base.c which are forward declared here
205 * for use by iwl-*.c
206 *
207 *****************************************************************************/
208extern int iwl3945_calc_db_from_ratio(int sig_ratio);
209extern void iwl3945_rx_replenish(void *data);
210extern void iwl3945_rx_queue_reset(struct iwl_priv *priv, struct iwl_rx_queue *rxq);
211extern unsigned int iwl3945_fill_beacon_frame(struct iwl_priv *priv,
212					struct ieee80211_hdr *hdr, int left);
213extern int iwl3945_dump_nic_event_log(struct iwl_priv *priv, bool full_log,
214				       char **buf, bool display);
215extern void iwl3945_dump_nic_error_log(struct iwl_priv *priv);
216
217/******************************************************************************
218 *
219 * Functions implemented in iwl-[34]*.c which are forward declared here
220 * for use by iwl3945-base.c
221 *
222 * NOTE:  The implementation of these functions are hardware specific
223 * which is why they are in the hardware specific files (vs. iwl-base.c)
224 *
225 * Naming convention --
226 * iwl3945_         <-- Its part of iwlwifi (should be changed to iwl3945_)
227 * iwl3945_hw_      <-- Hardware specific (implemented in iwl-XXXX.c by all HW)
228 * iwlXXXX_     <-- Hardware specific (implemented in iwl-XXXX.c for XXXX)
229 * iwl3945_bg_      <-- Called from work queue context
230 * iwl3945_mac_     <-- mac80211 callback
231 *
232 ****************************************************************************/
233extern void iwl3945_hw_rx_handler_setup(struct iwl_priv *priv);
234extern void iwl3945_hw_setup_deferred_work(struct iwl_priv *priv);
235extern void iwl3945_hw_cancel_deferred_work(struct iwl_priv *priv);
236extern int iwl3945_hw_rxq_stop(struct iwl_priv *priv);
237extern int iwl3945_hw_set_hw_params(struct iwl_priv *priv);
238extern int iwl3945_hw_nic_init(struct iwl_priv *priv);
239extern int iwl3945_hw_nic_stop_master(struct iwl_priv *priv);
240extern void iwl3945_hw_txq_ctx_free(struct iwl_priv *priv);
241extern void iwl3945_hw_txq_ctx_stop(struct iwl_priv *priv);
242extern int iwl3945_hw_nic_reset(struct iwl_priv *priv);
243extern int iwl3945_hw_txq_attach_buf_to_tfd(struct iwl_priv *priv,
244					    struct iwl_tx_queue *txq,
245					    dma_addr_t addr, u16 len,
246					    u8 reset, u8 pad);
247extern void iwl3945_hw_txq_free_tfd(struct iwl_priv *priv,
248				    struct iwl_tx_queue *txq);
249extern int iwl3945_hw_get_temperature(struct iwl_priv *priv);
250extern int iwl3945_hw_tx_queue_init(struct iwl_priv *priv,
251				struct iwl_tx_queue *txq);
252extern unsigned int iwl3945_hw_get_beacon_cmd(struct iwl_priv *priv,
253				 struct iwl3945_frame *frame, u8 rate);
254void iwl3945_hw_build_tx_cmd_rate(struct iwl_priv *priv,
255				  struct iwl_device_cmd *cmd,
256				  struct ieee80211_tx_info *info,
257				  struct ieee80211_hdr *hdr,
258				  int sta_id, int tx_id);
259extern int iwl3945_hw_reg_send_txpower(struct iwl_priv *priv);
260extern int iwl3945_hw_reg_set_txpower(struct iwl_priv *priv, s8 power);
261extern void iwl3945_hw_rx_statistics(struct iwl_priv *priv,
262				 struct iwl_rx_mem_buffer *rxb);
263void iwl3945_reply_statistics(struct iwl_priv *priv,
264			      struct iwl_rx_mem_buffer *rxb);
265extern void iwl3945_disable_events(struct iwl_priv *priv);
266extern int iwl4965_get_temperature(const struct iwl_priv *priv);
267extern void iwl3945_post_associate(struct iwl_priv *priv);
268extern void iwl3945_config_ap(struct iwl_priv *priv);
269
270extern int iwl3945_commit_rxon(struct iwl_priv *priv,
271			       struct iwl_rxon_context *ctx);
272
273/**
274 * iwl3945_hw_find_station - Find station id for a given BSSID
275 * @bssid: MAC address of station ID to find
276 *
277 * NOTE:  This should not be hardware specific but the code has
278 * not yet been merged into a single common layer for managing the
279 * station tables.
280 */
281extern u8 iwl3945_hw_find_station(struct iwl_priv *priv, const u8 *bssid);
282
283extern struct ieee80211_ops iwl3945_hw_ops;
284
285/*
286 * Forward declare iwl-3945.c functions for iwl3945-base.c
287 */
288extern __le32 iwl3945_get_antenna_flags(const struct iwl_priv *priv);
289extern int iwl3945_init_hw_rate_table(struct iwl_priv *priv);
290extern void iwl3945_reg_txpower_periodic(struct iwl_priv *priv);
291extern int iwl3945_txpower_set_from_eeprom(struct iwl_priv *priv);
292
293extern const struct iwl_channel_info *iwl3945_get_channel_info(
294	const struct iwl_priv *priv, enum ieee80211_band band, u16 channel);
295
296extern int iwl3945_rs_next_rate(struct iwl_priv *priv, int rate);
297
298/* scanning */
299int iwl3945_request_scan(struct iwl_priv *priv, struct ieee80211_vif *vif);
300void iwl3945_post_scan(struct iwl_priv *priv);
301
302/* rates */
303extern const struct iwl3945_rate_info iwl3945_rates[IWL_RATE_COUNT_3945];
304
305/* Requires full declaration of iwl_priv before including */
306#include "iwl-io.h"
307
308#endif