blob: 07256d280e51cc4a7f928eacc45e8d412a599a51 [file] [log] [blame]
Luciano Coelhof5fc0f82009-08-06 16:25:28 +03001/*
2 * This file is part of wl1271
3 *
4 * Copyright (C) 1998-2009 Texas Instruments. All rights reserved.
5 * Copyright (C) 2008-2009 Nokia Corporation
6 *
7 * Contact: Luciano Coelho <luciano.coelho@nokia.com>
8 *
9 * This program is free software; you can redistribute it and/or
10 * modify it under the terms of the GNU General Public License
11 * version 2 as published by the Free Software Foundation.
12 *
13 * This program is distributed in the hope that it will be useful, but
14 * WITHOUT ANY WARRANTY; without even the implied warranty of
15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
16 * General Public License for more details.
17 *
18 * You should have received a copy of the GNU General Public License
19 * along with this program; if not, write to the Free Software
20 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
21 * 02110-1301 USA
22 *
23 */
24
25#ifndef __WL1271_ACX_H__
26#define __WL1271_ACX_H__
27
28#include "wl1271.h"
29#include "wl1271_cmd.h"
30
31/*************************************************************************
32
33 Host Interrupt Register (WiLink -> Host)
34
35**************************************************************************/
36/* HW Initiated interrupt Watchdog timer expiration */
37#define WL1271_ACX_INTR_WATCHDOG BIT(0)
38/* Init sequence is done (masked interrupt, detection through polling only ) */
39#define WL1271_ACX_INTR_INIT_COMPLETE BIT(1)
40/* Event was entered to Event MBOX #A*/
41#define WL1271_ACX_INTR_EVENT_A BIT(2)
42/* Event was entered to Event MBOX #B*/
43#define WL1271_ACX_INTR_EVENT_B BIT(3)
44/* Command processing completion*/
45#define WL1271_ACX_INTR_CMD_COMPLETE BIT(4)
46/* Signaling the host on HW wakeup */
47#define WL1271_ACX_INTR_HW_AVAILABLE BIT(5)
48/* The MISC bit is used for aggregation of RX, TxComplete and TX rate update */
49#define WL1271_ACX_INTR_DATA BIT(6)
50/* Trace meassge on MBOX #A */
51#define WL1271_ACX_INTR_TRACE_A BIT(7)
52/* Trace meassge on MBOX #B */
53#define WL1271_ACX_INTR_TRACE_B BIT(8)
54
55#define WL1271_ACX_INTR_ALL 0xFFFFFFFF
56#define WL1271_ACX_ALL_EVENTS_VECTOR (WL1271_ACX_INTR_WATCHDOG | \
57 WL1271_ACX_INTR_INIT_COMPLETE | \
58 WL1271_ACX_INTR_EVENT_A | \
59 WL1271_ACX_INTR_EVENT_B | \
60 WL1271_ACX_INTR_CMD_COMPLETE | \
61 WL1271_ACX_INTR_HW_AVAILABLE | \
62 WL1271_ACX_INTR_DATA)
63
Luciano Coelho37079a82009-10-12 15:08:45 +030064#define WL1271_INTR_MASK (WL1271_ACX_INTR_EVENT_A | \
65 WL1271_ACX_INTR_EVENT_B | \
66 WL1271_ACX_INTR_HW_AVAILABLE | \
Luciano Coelhof5fc0f82009-08-06 16:25:28 +030067 WL1271_ACX_INTR_DATA)
68
69/* Target's information element */
70struct acx_header {
71 struct wl1271_cmd_header cmd;
72
73 /* acx (or information element) header */
74 u16 id;
75
76 /* payload length (not including headers */
77 u16 len;
78};
79
80struct acx_error_counter {
81 struct acx_header header;
82
83 /* The number of PLCP errors since the last time this */
84 /* information element was interrogated. This field is */
85 /* automatically cleared when it is interrogated.*/
86 u32 PLCP_error;
87
88 /* The number of FCS errors since the last time this */
89 /* information element was interrogated. This field is */
90 /* automatically cleared when it is interrogated.*/
91 u32 FCS_error;
92
93 /* The number of MPDUs without PLCP header errors received*/
94 /* since the last time this information element was interrogated. */
95 /* This field is automatically cleared when it is interrogated.*/
96 u32 valid_frame;
97
98 /* the number of missed sequence numbers in the squentially */
99 /* values of frames seq numbers */
100 u32 seq_num_miss;
101} __attribute__ ((packed));
102
103struct acx_revision {
104 struct acx_header header;
105
106 /*
107 * The WiLink firmware version, an ASCII string x.x.x.x,
108 * that uniquely identifies the current firmware.
109 * The left most digit is incremented each time a
110 * significant change is made to the firmware, such as
111 * code redesign or new platform support.
112 * The second digit is incremented when major enhancements
113 * are added or major fixes are made.
114 * The third digit is incremented for each GA release.
115 * The fourth digit is incremented for each build.
116 * The first two digits identify a firmware release version,
117 * in other words, a unique set of features.
118 * The first three digits identify a GA release.
119 */
120 char fw_version[20];
121
122 /*
123 * This 4 byte field specifies the WiLink hardware version.
124 * bits 0 - 15: Reserved.
125 * bits 16 - 23: Version ID - The WiLink version ID
126 * (1 = first spin, 2 = second spin, and so on).
127 * bits 24 - 31: Chip ID - The WiLink chip ID.
128 */
129 u32 hw_version;
130} __attribute__ ((packed));
131
132enum wl1271_psm_mode {
133 /* Active mode */
134 WL1271_PSM_CAM = 0,
135
136 /* Power save mode */
137 WL1271_PSM_PS = 1,
138
139 /* Extreme low power */
140 WL1271_PSM_ELP = 2,
141};
142
143struct acx_sleep_auth {
144 struct acx_header header;
145
146 /* The sleep level authorization of the device. */
147 /* 0 - Always active*/
148 /* 1 - Power down mode: light / fast sleep*/
149 /* 2 - ELP mode: Deep / Max sleep*/
150 u8 sleep_auth;
151 u8 padding[3];
152} __attribute__ ((packed));
153
154enum {
155 HOSTIF_PCI_MASTER_HOST_INDIRECT,
156 HOSTIF_PCI_MASTER_HOST_DIRECT,
157 HOSTIF_SLAVE,
158 HOSTIF_PKT_RING,
159 HOSTIF_DONTCARE = 0xFF
160};
161
162#define DEFAULT_UCAST_PRIORITY 0
163#define DEFAULT_RX_Q_PRIORITY 0
164#define DEFAULT_NUM_STATIONS 1
165#define DEFAULT_RXQ_PRIORITY 0 /* low 0 .. 15 high */
166#define DEFAULT_RXQ_TYPE 0x07 /* All frames, Data/Ctrl/Mgmt */
167#define TRACE_BUFFER_MAX_SIZE 256
168
169#define DP_RX_PACKET_RING_CHUNK_SIZE 1600
170#define DP_TX_PACKET_RING_CHUNK_SIZE 1600
171#define DP_RX_PACKET_RING_CHUNK_NUM 2
172#define DP_TX_PACKET_RING_CHUNK_NUM 2
173#define DP_TX_COMPLETE_TIME_OUT 20
Luciano Coelhof5fc0f82009-08-06 16:25:28 +0300174
175#define TX_MSDU_LIFETIME_MIN 0
176#define TX_MSDU_LIFETIME_MAX 3000
177#define TX_MSDU_LIFETIME_DEF 512
178#define RX_MSDU_LIFETIME_MIN 0
179#define RX_MSDU_LIFETIME_MAX 0xFFFFFFFF
180#define RX_MSDU_LIFETIME_DEF 512000
181
182struct acx_rx_msdu_lifetime {
183 struct acx_header header;
184
185 /*
186 * The maximum amount of time, in TU, before the
187 * firmware discards the MSDU.
188 */
189 u32 lifetime;
190} __attribute__ ((packed));
191
192/*
193 * RX Config Options Table
194 * Bit Definition
195 * === ==========
196 * 31:14 Reserved
197 * 13 Copy RX Status - when set, write three receive status words
198 * to top of rx'd MPDUs.
199 * When cleared, do not write three status words (added rev 1.5)
200 * 12 Reserved
201 * 11 RX Complete upon FCS error - when set, give rx complete
202 * interrupt for FCS errors, after the rx filtering, e.g. unicast
203 * frames not to us with FCS error will not generate an interrupt.
204 * 10 SSID Filter Enable - When set, the WiLink discards all beacon,
205 * probe request, and probe response frames with an SSID that does
206 * not match the SSID specified by the host in the START/JOIN
207 * command.
208 * When clear, the WiLink receives frames with any SSID.
209 * 9 Broadcast Filter Enable - When set, the WiLink discards all
210 * broadcast frames. When clear, the WiLink receives all received
211 * broadcast frames.
212 * 8:6 Reserved
213 * 5 BSSID Filter Enable - When set, the WiLink discards any frames
214 * with a BSSID that does not match the BSSID specified by the
215 * host.
216 * When clear, the WiLink receives frames from any BSSID.
217 * 4 MAC Addr Filter - When set, the WiLink discards any frames
218 * with a destination address that does not match the MAC address
219 * of the adaptor.
220 * When clear, the WiLink receives frames destined to any MAC
221 * address.
222 * 3 Promiscuous - When set, the WiLink receives all valid frames
223 * (i.e., all frames that pass the FCS check).
224 * When clear, only frames that pass the other filters specified
225 * are received.
226 * 2 FCS - When set, the WiLink includes the FCS with the received
227 * frame.
228 * When cleared, the FCS is discarded.
229 * 1 PLCP header - When set, write all data from baseband to frame
230 * buffer including PHY header.
231 * 0 Reserved - Always equal to 0.
232 *
233 * RX Filter Options Table
234 * Bit Definition
235 * === ==========
236 * 31:12 Reserved - Always equal to 0.
237 * 11 Association - When set, the WiLink receives all association
238 * related frames (association request/response, reassocation
239 * request/response, and disassociation). When clear, these frames
240 * are discarded.
241 * 10 Auth/De auth - When set, the WiLink receives all authentication
242 * and de-authentication frames. When clear, these frames are
243 * discarded.
244 * 9 Beacon - When set, the WiLink receives all beacon frames.
245 * When clear, these frames are discarded.
246 * 8 Contention Free - When set, the WiLink receives all contention
247 * free frames.
248 * When clear, these frames are discarded.
249 * 7 Control - When set, the WiLink receives all control frames.
250 * When clear, these frames are discarded.
251 * 6 Data - When set, the WiLink receives all data frames.
252 * When clear, these frames are discarded.
253 * 5 FCS Error - When set, the WiLink receives frames that have FCS
254 * errors.
255 * When clear, these frames are discarded.
256 * 4 Management - When set, the WiLink receives all management
257 * frames.
258 * When clear, these frames are discarded.
259 * 3 Probe Request - When set, the WiLink receives all probe request
260 * frames.
261 * When clear, these frames are discarded.
262 * 2 Probe Response - When set, the WiLink receives all probe
263 * response frames.
264 * When clear, these frames are discarded.
265 * 1 RTS/CTS/ACK - When set, the WiLink receives all RTS, CTS and ACK
266 * frames.
267 * When clear, these frames are discarded.
268 * 0 Rsvd Type/Sub Type - When set, the WiLink receives all frames
269 * that have reserved frame types and sub types as defined by the
270 * 802.11 specification.
271 * When clear, these frames are discarded.
272 */
273struct acx_rx_config {
274 struct acx_header header;
275
276 u32 config_options;
277 u32 filter_options;
278} __attribute__ ((packed));
279
280struct acx_packet_detection {
281 struct acx_header header;
282
283 u32 threshold;
284} __attribute__ ((packed));
285
286
287enum acx_slot_type {
288 SLOT_TIME_LONG = 0,
289 SLOT_TIME_SHORT = 1,
290 DEFAULT_SLOT_TIME = SLOT_TIME_SHORT,
291 MAX_SLOT_TIMES = 0xFF
292};
293
294#define STATION_WONE_INDEX 0
295
296struct acx_slot {
297 struct acx_header header;
298
299 u8 wone_index; /* Reserved */
300 u8 slot_time;
301 u8 reserved[6];
302} __attribute__ ((packed));
303
304
Juuso Oikarinenc87dec92009-10-08 21:56:31 +0300305#define ACX_MC_ADDRESS_GROUP_MAX (8)
306#define ADDRESS_GROUP_MAX_LEN (ETH_ALEN * ACX_MC_ADDRESS_GROUP_MAX)
Luciano Coelhof5fc0f82009-08-06 16:25:28 +0300307
308struct acx_dot11_grp_addr_tbl {
309 struct acx_header header;
310
311 u8 enabled;
312 u8 num_groups;
313 u8 pad[2];
314 u8 mac_table[ADDRESS_GROUP_MAX_LEN];
315} __attribute__ ((packed));
316
Luciano Coelhof5fc0f82009-08-06 16:25:28 +0300317#define RX_TIMEOUT_PS_POLL_MIN 0
318#define RX_TIMEOUT_PS_POLL_MAX (200000)
319#define RX_TIMEOUT_PS_POLL_DEF (15)
320#define RX_TIMEOUT_UPSD_MIN 0
321#define RX_TIMEOUT_UPSD_MAX (200000)
322#define RX_TIMEOUT_UPSD_DEF (15)
323
324struct acx_rx_timeout {
325 struct acx_header header;
326
327 /*
328 * The longest time the STA will wait to receive
329 * traffic from the AP after a PS-poll has been
330 * transmitted.
331 */
332 u16 ps_poll_timeout;
333
334 /*
335 * The longest time the STA will wait to receive
336 * traffic from the AP after a frame has been sent
337 * from an UPSD enabled queue.
338 */
339 u16 upsd_timeout;
340} __attribute__ ((packed));
341
342#define RTS_THRESHOLD_MIN 0
343#define RTS_THRESHOLD_MAX 4096
344#define RTS_THRESHOLD_DEF 2347
345
346struct acx_rts_threshold {
347 struct acx_header header;
348
349 u16 threshold;
350 u8 pad[2];
351} __attribute__ ((packed));
352
353struct acx_beacon_filter_option {
354 struct acx_header header;
355
356 u8 enable;
357
358 /*
359 * The number of beacons without the unicast TIM
360 * bit set that the firmware buffers before
361 * signaling the host about ready frames.
362 * When set to 0 and the filter is enabled, beacons
363 * without the unicast TIM bit set are dropped.
364 */
365 u8 max_num_beacons;
366 u8 pad[2];
367} __attribute__ ((packed));
368
369/*
370 * ACXBeaconFilterEntry (not 221)
371 * Byte Offset Size (Bytes) Definition
372 * =========== ============ ==========
373 * 0 1 IE identifier
374 * 1 1 Treatment bit mask
375 *
376 * ACXBeaconFilterEntry (221)
377 * Byte Offset Size (Bytes) Definition
378 * =========== ============ ==========
379 * 0 1 IE identifier
380 * 1 1 Treatment bit mask
381 * 2 3 OUI
382 * 5 1 Type
383 * 6 2 Version
384 *
385 *
386 * Treatment bit mask - The information element handling:
387 * bit 0 - The information element is compared and transferred
388 * in case of change.
389 * bit 1 - The information element is transferred to the host
390 * with each appearance or disappearance.
391 * Note that both bits can be set at the same time.
392 */
393#define BEACON_FILTER_TABLE_MAX_IE_NUM (32)
394#define BEACON_FILTER_TABLE_MAX_VENDOR_SPECIFIC_IE_NUM (6)
395#define BEACON_FILTER_TABLE_IE_ENTRY_SIZE (2)
396#define BEACON_FILTER_TABLE_EXTRA_VENDOR_SPECIFIC_IE_SIZE (6)
397#define BEACON_FILTER_TABLE_MAX_SIZE ((BEACON_FILTER_TABLE_MAX_IE_NUM * \
398 BEACON_FILTER_TABLE_IE_ENTRY_SIZE) + \
399 (BEACON_FILTER_TABLE_MAX_VENDOR_SPECIFIC_IE_NUM * \
400 BEACON_FILTER_TABLE_EXTRA_VENDOR_SPECIFIC_IE_SIZE))
401
Juuso Oikarinen19221672009-10-08 21:56:35 +0300402#define BEACON_RULE_PASS_ON_CHANGE BIT(0)
403#define BEACON_RULE_PASS_ON_APPEARANCE BIT(1)
404
405#define BEACON_FILTER_IE_ID_CHANNEL_SWITCH_ANN (37)
406
Luciano Coelhof5fc0f82009-08-06 16:25:28 +0300407struct acx_beacon_filter_ie_table {
408 struct acx_header header;
409
410 u8 num_ie;
411 u8 table[BEACON_FILTER_TABLE_MAX_SIZE];
412 u8 pad[3];
413} __attribute__ ((packed));
414
Juuso Oikarinen34415232009-10-08 21:56:33 +0300415#define SYNCH_FAIL_DEFAULT_THRESHOLD 5 /* number of beacons */
416#define NO_BEACON_DEFAULT_TIMEOUT (100) /* TU */
417
418struct acx_conn_monit_params {
419 struct acx_header header;
420
421 u32 synch_fail_thold; /* number of beacons missed */
422 u32 bss_lose_timeout; /* number of TU's from synch fail */
423};
424
Luciano Coelhof5fc0f82009-08-06 16:25:28 +0300425enum {
426 SG_ENABLE = 0,
427 SG_DISABLE,
428 SG_SENSE_NO_ACTIVITY,
429 SG_SENSE_ACTIVE
430};
431
432struct acx_bt_wlan_coex {
433 struct acx_header header;
434
435 /*
436 * 0 -> PTA enabled
437 * 1 -> PTA disabled
438 * 2 -> sense no active mode, i.e.
439 * an interrupt is sent upon
440 * BT activity.
441 * 3 -> PTA is switched on in response
442 * to the interrupt sending.
443 */
444 u8 enable;
445 u8 pad[3];
446} __attribute__ ((packed));
447
448#define PTA_ANTENNA_TYPE_DEF (0)
449#define PTA_BT_HP_MAXTIME_DEF (2000)
450#define PTA_WLAN_HP_MAX_TIME_DEF (5000)
451#define PTA_SENSE_DISABLE_TIMER_DEF (1350)
452#define PTA_PROTECTIVE_RX_TIME_DEF (1500)
453#define PTA_PROTECTIVE_TX_TIME_DEF (1500)
454#define PTA_TIMEOUT_NEXT_BT_LP_PACKET_DEF (3000)
455#define PTA_SIGNALING_TYPE_DEF (1)
456#define PTA_AFH_LEVERAGE_ON_DEF (0)
457#define PTA_NUMBER_QUIET_CYCLE_DEF (0)
458#define PTA_MAX_NUM_CTS_DEF (3)
459#define PTA_NUMBER_OF_WLAN_PACKETS_DEF (2)
460#define PTA_NUMBER_OF_BT_PACKETS_DEF (2)
461#define PTA_PROTECTIVE_RX_TIME_FAST_DEF (1500)
462#define PTA_PROTECTIVE_TX_TIME_FAST_DEF (3000)
463#define PTA_CYCLE_TIME_FAST_DEF (8700)
464#define PTA_RX_FOR_AVALANCHE_DEF (5)
465#define PTA_ELP_HP_DEF (0)
466#define PTA_ANTI_STARVE_PERIOD_DEF (500)
467#define PTA_ANTI_STARVE_NUM_CYCLE_DEF (4)
468#define PTA_ALLOW_PA_SD_DEF (1)
469#define PTA_TIME_BEFORE_BEACON_DEF (6300)
470#define PTA_HPDM_MAX_TIME_DEF (1600)
471#define PTA_TIME_OUT_NEXT_WLAN_DEF (2550)
472#define PTA_AUTO_MODE_NO_CTS_DEF (0)
473#define PTA_BT_HP_RESPECTED_DEF (3)
474#define PTA_WLAN_RX_MIN_RATE_DEF (24)
475#define PTA_ACK_MODE_DEF (1)
476
477struct acx_bt_wlan_coex_param {
478 struct acx_header header;
479
480 /*
481 * The minimum rate of a received WLAN packet in the STA,
482 * during protective mode, of which a new BT-HP request
483 * during this Rx will always be respected and gain the antenna.
484 */
485 u32 min_rate;
486
487 /* Max time the BT HP will be respected. */
488 u16 bt_hp_max_time;
489
490 /* Max time the WLAN HP will be respected. */
491 u16 wlan_hp_max_time;
492
493 /*
494 * The time between the last BT activity
495 * and the moment when the sense mode returns
496 * to SENSE_INACTIVE.
497 */
498 u16 sense_disable_timer;
499
500 /* Time before the next BT HP instance */
501 u16 rx_time_bt_hp;
502 u16 tx_time_bt_hp;
503
504 /* range: 10-20000 default: 1500 */
505 u16 rx_time_bt_hp_fast;
506 u16 tx_time_bt_hp_fast;
507
508 /* range: 2000-65535 default: 8700 */
509 u16 wlan_cycle_fast;
510
511 /* range: 0 - 15000 (Msec) default: 1000 */
512 u16 bt_anti_starvation_period;
513
514 /* range 400-10000(Usec) default: 3000 */
515 u16 next_bt_lp_packet;
516
517 /* Deafult: worst case for BT DH5 traffic */
518 u16 wake_up_beacon;
519
520 /* range: 0-50000(Usec) default: 1050 */
521 u16 hp_dm_max_guard_time;
522
523 /*
524 * This is to prevent both BT & WLAN antenna
525 * starvation.
526 * Range: 100-50000(Usec) default:2550
527 */
528 u16 next_wlan_packet;
529
530 /* 0 -> shared antenna */
531 u8 antenna_type;
532
533 /*
534 * 0 -> TI legacy
535 * 1 -> Palau
536 */
537 u8 signal_type;
538
539 /*
540 * BT AFH status
541 * 0 -> no AFH
542 * 1 -> from dedicated GPIO
543 * 2 -> AFH on (from host)
544 */
545 u8 afh_leverage_on;
546
547 /*
548 * The number of cycles during which no
549 * TX will be sent after 1 cycle of RX
550 * transaction in protective mode
551 */
552 u8 quiet_cycle_num;
553
554 /*
555 * The maximum number of CTSs that will
556 * be sent for receiving RX packet in
557 * protective mode
558 */
559 u8 max_cts;
560
561 /*
562 * The number of WLAN packets
563 * transferred in common mode before
564 * switching to BT.
565 */
566 u8 wlan_packets_num;
567
568 /*
569 * The number of BT packets
570 * transferred in common mode before
571 * switching to WLAN.
572 */
573 u8 bt_packets_num;
574
575 /* range: 1-255 default: 5 */
576 u8 missed_rx_avalanche;
577
578 /* range: 0-1 default: 1 */
579 u8 wlan_elp_hp;
580
581 /* range: 0 - 15 default: 4 */
582 u8 bt_anti_starvation_cycles;
583
584 u8 ack_mode_dual_ant;
585
586 /*
587 * Allow PA_SD assertion/de-assertion
588 * during enabled BT activity.
589 */
590 u8 pa_sd_enable;
591
592 /*
593 * Enable/Disable PTA in auto mode:
594 * Support Both Active & P.S modes
595 */
596 u8 pta_auto_mode_enable;
597
598 /* range: 0 - 20 default: 1 */
599 u8 bt_hp_respected_num;
600} __attribute__ ((packed));
601
602#define CCA_THRSH_ENABLE_ENERGY_D 0x140A
603#define CCA_THRSH_DISABLE_ENERGY_D 0xFFEF
604
605struct acx_energy_detection {
606 struct acx_header header;
607
608 /* The RX Clear Channel Assessment threshold in the PHY */
609 u16 rx_cca_threshold;
610 u8 tx_energy_detection;
611 u8 pad;
612} __attribute__ ((packed));
613
614#define BCN_RX_TIMEOUT_DEF_VALUE 10000
615#define BROADCAST_RX_TIMEOUT_DEF_VALUE 20000
616#define RX_BROADCAST_IN_PS_DEF_VALUE 1
617#define CONSECUTIVE_PS_POLL_FAILURE_DEF 4
618
619struct acx_beacon_broadcast {
620 struct acx_header header;
621
622 u16 beacon_rx_timeout;
623 u16 broadcast_timeout;
624
625 /* Enables receiving of broadcast packets in PS mode */
626 u8 rx_broadcast_in_ps;
627
628 /* Consecutive PS Poll failures before updating the host */
629 u8 ps_poll_threshold;
630 u8 pad[2];
631} __attribute__ ((packed));
632
633struct acx_event_mask {
634 struct acx_header header;
635
636 u32 event_mask;
637 u32 high_event_mask; /* Unused */
638} __attribute__ ((packed));
639
640#define CFG_RX_FCS BIT(2)
641#define CFG_RX_ALL_GOOD BIT(3)
642#define CFG_UNI_FILTER_EN BIT(4)
643#define CFG_BSSID_FILTER_EN BIT(5)
644#define CFG_MC_FILTER_EN BIT(6)
645#define CFG_MC_ADDR0_EN BIT(7)
646#define CFG_MC_ADDR1_EN BIT(8)
647#define CFG_BC_REJECT_EN BIT(9)
648#define CFG_SSID_FILTER_EN BIT(10)
649#define CFG_RX_INT_FCS_ERROR BIT(11)
650#define CFG_RX_INT_ENCRYPTED BIT(12)
651#define CFG_RX_WR_RX_STATUS BIT(13)
652#define CFG_RX_FILTER_NULTI BIT(14)
653#define CFG_RX_RESERVE BIT(15)
654#define CFG_RX_TIMESTAMP_TSF BIT(16)
655
656#define CFG_RX_RSV_EN BIT(0)
657#define CFG_RX_RCTS_ACK BIT(1)
658#define CFG_RX_PRSP_EN BIT(2)
659#define CFG_RX_PREQ_EN BIT(3)
660#define CFG_RX_MGMT_EN BIT(4)
661#define CFG_RX_FCS_ERROR BIT(5)
662#define CFG_RX_DATA_EN BIT(6)
663#define CFG_RX_CTL_EN BIT(7)
664#define CFG_RX_CF_EN BIT(8)
665#define CFG_RX_BCN_EN BIT(9)
666#define CFG_RX_AUTH_EN BIT(10)
667#define CFG_RX_ASSOC_EN BIT(11)
668
669#define SCAN_PASSIVE BIT(0)
670#define SCAN_5GHZ_BAND BIT(1)
671#define SCAN_TRIGGERED BIT(2)
672#define SCAN_PRIORITY_HIGH BIT(3)
673
674struct acx_feature_config {
675 struct acx_header header;
676
677 u32 options;
678 u32 data_flow_options;
679} __attribute__ ((packed));
680
681struct acx_current_tx_power {
682 struct acx_header header;
683
684 u8 current_tx_power;
685 u8 padding[3];
686} __attribute__ ((packed));
687
688enum acx_wake_up_event {
689 WAKE_UP_EVENT_BEACON_BITMAP = 0x01, /* Wake on every Beacon*/
690 WAKE_UP_EVENT_DTIM_BITMAP = 0x02, /* Wake on every DTIM*/
691 WAKE_UP_EVENT_N_DTIM_BITMAP = 0x04, /* Wake on every Nth DTIM */
692 WAKE_UP_EVENT_N_BEACONS_BITMAP = 0x08, /* Wake on every Nth Beacon */
693 WAKE_UP_EVENT_BITS_MASK = 0x0F
694};
695
696struct acx_wake_up_condition {
697 struct acx_header header;
698
699 u8 wake_up_event; /* Only one bit can be set */
700 u8 listen_interval;
701 u8 pad[2];
702} __attribute__ ((packed));
703
704struct acx_aid {
705 struct acx_header header;
706
707 /*
708 * To be set when associated with an AP.
709 */
710 u16 aid;
711 u8 pad[2];
712} __attribute__ ((packed));
713
714enum acx_preamble_type {
715 ACX_PREAMBLE_LONG = 0,
716 ACX_PREAMBLE_SHORT = 1
717};
718
719struct acx_preamble {
720 struct acx_header header;
721
722 /*
723 * When set, the WiLink transmits the frames with a short preamble and
724 * when cleared, the WiLink transmits the frames with a long preamble.
725 */
726 u8 preamble;
727 u8 padding[3];
728} __attribute__ ((packed));
729
730enum acx_ctsprotect_type {
731 CTSPROTECT_DISABLE = 0,
732 CTSPROTECT_ENABLE = 1
733};
734
735struct acx_ctsprotect {
736 struct acx_header header;
737 u8 ctsprotect;
738 u8 padding[3];
739} __attribute__ ((packed));
740
741struct acx_tx_statistics {
742 u32 internal_desc_overflow;
743} __attribute__ ((packed));
744
745struct acx_rx_statistics {
746 u32 out_of_mem;
747 u32 hdr_overflow;
748 u32 hw_stuck;
749 u32 dropped;
750 u32 fcs_err;
751 u32 xfr_hint_trig;
752 u32 path_reset;
753 u32 reset_counter;
754} __attribute__ ((packed));
755
756struct acx_dma_statistics {
757 u32 rx_requested;
758 u32 rx_errors;
759 u32 tx_requested;
760 u32 tx_errors;
761} __attribute__ ((packed));
762
763struct acx_isr_statistics {
764 /* host command complete */
765 u32 cmd_cmplt;
766
767 /* fiqisr() */
768 u32 fiqs;
769
770 /* (INT_STS_ND & INT_TRIG_RX_HEADER) */
771 u32 rx_headers;
772
773 /* (INT_STS_ND & INT_TRIG_RX_CMPLT) */
774 u32 rx_completes;
775
776 /* (INT_STS_ND & INT_TRIG_NO_RX_BUF) */
777 u32 rx_mem_overflow;
778
779 /* (INT_STS_ND & INT_TRIG_S_RX_RDY) */
780 u32 rx_rdys;
781
782 /* irqisr() */
783 u32 irqs;
784
785 /* (INT_STS_ND & INT_TRIG_TX_PROC) */
786 u32 tx_procs;
787
788 /* (INT_STS_ND & INT_TRIG_DECRYPT_DONE) */
789 u32 decrypt_done;
790
791 /* (INT_STS_ND & INT_TRIG_DMA0) */
792 u32 dma0_done;
793
794 /* (INT_STS_ND & INT_TRIG_DMA1) */
795 u32 dma1_done;
796
797 /* (INT_STS_ND & INT_TRIG_TX_EXC_CMPLT) */
798 u32 tx_exch_complete;
799
800 /* (INT_STS_ND & INT_TRIG_COMMAND) */
801 u32 commands;
802
803 /* (INT_STS_ND & INT_TRIG_RX_PROC) */
804 u32 rx_procs;
805
806 /* (INT_STS_ND & INT_TRIG_PM_802) */
807 u32 hw_pm_mode_changes;
808
809 /* (INT_STS_ND & INT_TRIG_ACKNOWLEDGE) */
810 u32 host_acknowledges;
811
812 /* (INT_STS_ND & INT_TRIG_PM_PCI) */
813 u32 pci_pm;
814
815 /* (INT_STS_ND & INT_TRIG_ACM_WAKEUP) */
816 u32 wakeups;
817
818 /* (INT_STS_ND & INT_TRIG_LOW_RSSI) */
819 u32 low_rssi;
820} __attribute__ ((packed));
821
822struct acx_wep_statistics {
823 /* WEP address keys configured */
824 u32 addr_key_count;
825
826 /* default keys configured */
827 u32 default_key_count;
828
829 u32 reserved;
830
831 /* number of times that WEP key not found on lookup */
832 u32 key_not_found;
833
834 /* number of times that WEP key decryption failed */
835 u32 decrypt_fail;
836
837 /* WEP packets decrypted */
838 u32 packets;
839
840 /* WEP decrypt interrupts */
841 u32 interrupt;
842} __attribute__ ((packed));
843
844#define ACX_MISSED_BEACONS_SPREAD 10
845
846struct acx_pwr_statistics {
847 /* the amount of enters into power save mode (both PD & ELP) */
848 u32 ps_enter;
849
850 /* the amount of enters into ELP mode */
851 u32 elp_enter;
852
853 /* the amount of missing beacon interrupts to the host */
854 u32 missing_bcns;
855
856 /* the amount of wake on host-access times */
857 u32 wake_on_host;
858
859 /* the amount of wake on timer-expire */
860 u32 wake_on_timer_exp;
861
862 /* the number of packets that were transmitted with PS bit set */
863 u32 tx_with_ps;
864
865 /* the number of packets that were transmitted with PS bit clear */
866 u32 tx_without_ps;
867
868 /* the number of received beacons */
869 u32 rcvd_beacons;
870
871 /* the number of entering into PowerOn (power save off) */
872 u32 power_save_off;
873
874 /* the number of entries into power save mode */
875 u16 enable_ps;
876
877 /*
878 * the number of exits from power save, not including failed PS
879 * transitions
880 */
881 u16 disable_ps;
882
883 /*
884 * the number of times the TSF counter was adjusted because
885 * of drift
886 */
887 u32 fix_tsf_ps;
888
889 /* Gives statistics about the spread continuous missed beacons.
890 * The 16 LSB are dedicated for the PS mode.
891 * The 16 MSB are dedicated for the PS mode.
892 * cont_miss_bcns_spread[0] - single missed beacon.
893 * cont_miss_bcns_spread[1] - two continuous missed beacons.
894 * cont_miss_bcns_spread[2] - three continuous missed beacons.
895 * ...
896 * cont_miss_bcns_spread[9] - ten and more continuous missed beacons.
897 */
898 u32 cont_miss_bcns_spread[ACX_MISSED_BEACONS_SPREAD];
899
900 /* the number of beacons in awake mode */
901 u32 rcvd_awake_beacons;
902} __attribute__ ((packed));
903
904struct acx_mic_statistics {
905 u32 rx_pkts;
906 u32 calc_failure;
907} __attribute__ ((packed));
908
909struct acx_aes_statistics {
910 u32 encrypt_fail;
911 u32 decrypt_fail;
912 u32 encrypt_packets;
913 u32 decrypt_packets;
914 u32 encrypt_interrupt;
915 u32 decrypt_interrupt;
916} __attribute__ ((packed));
917
918struct acx_event_statistics {
919 u32 heart_beat;
920 u32 calibration;
921 u32 rx_mismatch;
922 u32 rx_mem_empty;
923 u32 rx_pool;
924 u32 oom_late;
925 u32 phy_transmit_error;
926 u32 tx_stuck;
927} __attribute__ ((packed));
928
929struct acx_ps_statistics {
930 u32 pspoll_timeouts;
931 u32 upsd_timeouts;
932 u32 upsd_max_sptime;
933 u32 upsd_max_apturn;
934 u32 pspoll_max_apturn;
935 u32 pspoll_utilization;
936 u32 upsd_utilization;
937} __attribute__ ((packed));
938
939struct acx_rxpipe_statistics {
940 u32 rx_prep_beacon_drop;
941 u32 descr_host_int_trig_rx_data;
942 u32 beacon_buffer_thres_host_int_trig_rx_data;
943 u32 missed_beacon_host_int_trig_rx_data;
944 u32 tx_xfr_host_int_trig_rx_data;
945} __attribute__ ((packed));
946
947struct acx_statistics {
948 struct acx_header header;
949
950 struct acx_tx_statistics tx;
951 struct acx_rx_statistics rx;
952 struct acx_dma_statistics dma;
953 struct acx_isr_statistics isr;
954 struct acx_wep_statistics wep;
955 struct acx_pwr_statistics pwr;
956 struct acx_aes_statistics aes;
957 struct acx_mic_statistics mic;
958 struct acx_event_statistics event;
959 struct acx_ps_statistics ps;
960 struct acx_rxpipe_statistics rxpipe;
961} __attribute__ ((packed));
962
963#define ACX_MAX_RATE_CLASSES 8
964#define ACX_RATE_MASK_UNSPECIFIED 0
965#define ACX_RATE_MASK_ALL 0x1eff
966#define ACX_RATE_RETRY_LIMIT 10
967
968struct acx_rate_class {
969 u32 enabled_rates;
970 u8 short_retry_limit;
971 u8 long_retry_limit;
972 u8 aflags;
973 u8 reserved;
974};
975
976struct acx_rate_policy {
977 struct acx_header header;
978
979 u32 rate_class_cnt;
980 struct acx_rate_class rate_class[ACX_MAX_RATE_CLASSES];
981} __attribute__ ((packed));
982
983#define WL1271_ACX_AC_COUNT 4
984
985struct acx_ac_cfg {
986 struct acx_header header;
987 u8 ac;
988 u8 cw_min;
989 u16 cw_max;
990 u8 aifsn;
991 u8 reserved;
992 u16 tx_op_limit;
993} __attribute__ ((packed));
994
995enum wl1271_acx_ac {
996 WL1271_ACX_AC_BE = 0,
997 WL1271_ACX_AC_BK = 1,
998 WL1271_ACX_AC_VI = 2,
999 WL1271_ACX_AC_VO = 3,
1000 WL1271_ACX_AC_CTS2SELF = 4,
1001 WL1271_ACX_AC_ANY_TID = 0x1F,
1002 WL1271_ACX_AC_INVALID = 0xFF,
1003};
1004
1005enum wl1271_acx_ps_scheme {
1006 WL1271_ACX_PS_SCHEME_LEGACY = 0,
1007 WL1271_ACX_PS_SCHEME_UPSD_TRIGGER = 1,
1008 WL1271_ACX_PS_SCHEME_LEGACY_PSPOLL = 2,
1009 WL1271_ACX_PS_SCHEME_SAPSD = 3,
1010};
1011
1012enum wl1271_acx_ack_policy {
1013 WL1271_ACX_ACK_POLICY_LEGACY = 0,
1014 WL1271_ACX_ACK_POLICY_NO_ACK = 1,
1015 WL1271_ACX_ACK_POLICY_BLOCK = 2,
1016};
1017
1018#define WL1271_ACX_TID_COUNT 7
1019
1020struct acx_tid_config {
1021 struct acx_header header;
1022 u8 queue_id;
1023 u8 channel_type;
1024 u8 tsid;
1025 u8 ps_scheme;
1026 u8 ack_policy;
1027 u8 padding[3];
1028 u32 apsd_conf[2];
1029} __attribute__ ((packed));
1030
1031struct acx_frag_threshold {
1032 struct acx_header header;
1033 u16 frag_threshold;
1034 u8 padding[2];
1035} __attribute__ ((packed));
1036
1037#define WL1271_ACX_TX_COMPL_TIMEOUT 5
1038#define WL1271_ACX_TX_COMPL_THRESHOLD 5
1039
1040struct acx_tx_config_options {
1041 struct acx_header header;
1042 u16 tx_compl_timeout; /* msec */
1043 u16 tx_compl_threshold; /* number of packets */
1044} __attribute__ ((packed));
1045
1046#define ACX_RX_MEM_BLOCKS 64
1047#define ACX_TX_MIN_MEM_BLOCKS 64
1048#define ACX_TX_DESCRIPTORS 32
1049#define ACX_NUM_SSID_PROFILES 1
1050
1051struct wl1271_acx_config_memory {
1052 struct acx_header header;
1053
1054 u8 rx_mem_block_num;
1055 u8 tx_min_mem_block_num;
1056 u8 num_stations;
1057 u8 num_ssid_profiles;
1058 u32 total_tx_descriptors;
1059} __attribute__ ((packed));
1060
1061struct wl1271_acx_mem_map {
1062 struct acx_header header;
1063
1064 void *code_start;
1065 void *code_end;
1066
1067 void *wep_defkey_start;
1068 void *wep_defkey_end;
1069
1070 void *sta_table_start;
1071 void *sta_table_end;
1072
1073 void *packet_template_start;
1074 void *packet_template_end;
1075
1076 /* Address of the TX result interface (control block) */
1077 u32 tx_result;
1078 u32 tx_result_queue_start;
1079
1080 void *queue_memory_start;
1081 void *queue_memory_end;
1082
1083 u32 packet_memory_pool_start;
1084 u32 packet_memory_pool_end;
1085
1086 void *debug_buffer1_start;
1087 void *debug_buffer1_end;
1088
1089 void *debug_buffer2_start;
1090 void *debug_buffer2_end;
1091
1092 /* Number of blocks FW allocated for TX packets */
1093 u32 num_tx_mem_blocks;
1094
1095 /* Number of blocks FW allocated for RX packets */
1096 u32 num_rx_mem_blocks;
1097
1098 /* the following 4 fields are valid in SLAVE mode only */
1099 u8 *tx_cbuf;
1100 u8 *rx_cbuf;
1101 void *rx_ctrl;
1102 void *tx_ctrl;
1103} __attribute__ ((packed));
1104
1105enum wl1271_acx_rx_queue_type {
1106 RX_QUEUE_TYPE_RX_LOW_PRIORITY, /* All except the high priority */
1107 RX_QUEUE_TYPE_RX_HIGH_PRIORITY, /* Management and voice packets */
1108 RX_QUEUE_TYPE_NUM,
1109 RX_QUEUE_TYPE_MAX = USHORT_MAX
1110};
1111
1112#define WL1271_RX_INTR_THRESHOLD_DEF 0 /* no pacing, send interrupt on
1113 * every event */
1114#define WL1271_RX_INTR_THRESHOLD_MIN 0
1115#define WL1271_RX_INTR_THRESHOLD_MAX 15
1116
1117#define WL1271_RX_INTR_TIMEOUT_DEF 5
1118#define WL1271_RX_INTR_TIMEOUT_MIN 1
1119#define WL1271_RX_INTR_TIMEOUT_MAX 100
1120
1121struct wl1271_acx_rx_config_opt {
1122 struct acx_header header;
1123
1124 u16 mblk_threshold;
1125 u16 threshold;
1126 u16 timeout;
1127 u8 queue_type;
1128 u8 reserved;
1129} __attribute__ ((packed));
1130
1131enum {
1132 ACX_WAKE_UP_CONDITIONS = 0x0002,
1133 ACX_MEM_CFG = 0x0003,
1134 ACX_SLOT = 0x0004,
1135 ACX_AC_CFG = 0x0007,
1136 ACX_MEM_MAP = 0x0008,
1137 ACX_AID = 0x000A,
1138 /* ACX_FW_REV is missing in the ref driver, but seems to work */
1139 ACX_FW_REV = 0x000D,
1140 ACX_MEDIUM_USAGE = 0x000F,
1141 ACX_RX_CFG = 0x0010,
1142 ACX_TX_QUEUE_CFG = 0x0011, /* FIXME: only used by wl1251 */
1143 ACX_STATISTICS = 0x0013, /* Debug API */
1144 ACX_PWR_CONSUMPTION_STATISTICS = 0x0014,
1145 ACX_FEATURE_CFG = 0x0015,
1146 ACX_TID_CFG = 0x001A,
1147 ACX_PS_RX_STREAMING = 0x001B,
1148 ACX_BEACON_FILTER_OPT = 0x001F,
1149 ACX_NOISE_HIST = 0x0021,
1150 ACX_HDK_VERSION = 0x0022, /* ??? */
1151 ACX_PD_THRESHOLD = 0x0023,
1152 ACX_TX_CONFIG_OPT = 0x0024,
1153 ACX_CCA_THRESHOLD = 0x0025,
1154 ACX_EVENT_MBOX_MASK = 0x0026,
1155 ACX_CONN_MONIT_PARAMS = 0x002D,
1156 ACX_CONS_TX_FAILURE = 0x002F,
1157 ACX_BCN_DTIM_OPTIONS = 0x0031,
1158 ACX_SG_ENABLE = 0x0032,
1159 ACX_SG_CFG = 0x0033,
1160 ACX_BEACON_FILTER_TABLE = 0x0038,
1161 ACX_ARP_IP_FILTER = 0x0039,
1162 ACX_ROAMING_STATISTICS_TBL = 0x003B,
1163 ACX_RATE_POLICY = 0x003D,
1164 ACX_CTS_PROTECTION = 0x003E,
1165 ACX_SLEEP_AUTH = 0x003F,
1166 ACX_PREAMBLE_TYPE = 0x0040,
1167 ACX_ERROR_CNT = 0x0041,
1168 ACX_IBSS_FILTER = 0x0044,
1169 ACX_SERVICE_PERIOD_TIMEOUT = 0x0045,
1170 ACX_TSF_INFO = 0x0046,
1171 ACX_CONFIG_PS_WMM = 0x0049,
1172 ACX_ENABLE_RX_DATA_FILTER = 0x004A,
1173 ACX_SET_RX_DATA_FILTER = 0x004B,
1174 ACX_GET_DATA_FILTER_STATISTICS = 0x004C,
1175 ACX_RX_CONFIG_OPT = 0x004E,
1176 ACX_FRAG_CFG = 0x004F,
1177 ACX_BET_ENABLE = 0x0050,
1178 ACX_RSSI_SNR_TRIGGER = 0x0051,
1179 ACX_RSSI_SNR_WEIGHTS = 0x0051,
1180 ACX_KEEP_ALIVE_MODE = 0x0052,
1181 ACX_SET_KEEP_ALIVE_CONFIG = 0x0054,
1182 ACX_BA_SESSION_RESPONDER_POLICY = 0x0055,
1183 ACX_BA_SESSION_INITIATOR_POLICY = 0x0056,
1184 ACX_PEER_HT_CAP = 0x0057,
1185 ACX_HT_BSS_OPERATION = 0x0058,
1186 ACX_COEX_ACTIVITY = 0x0059,
1187 DOT11_RX_MSDU_LIFE_TIME = 0x1004,
1188 DOT11_CUR_TX_PWR = 0x100D,
1189 DOT11_RX_DOT11_MODE = 0x1012,
1190 DOT11_RTS_THRESHOLD = 0x1013,
1191 DOT11_GROUP_ADDRESS_TBL = 0x1014,
1192
1193 MAX_DOT11_IE = DOT11_GROUP_ADDRESS_TBL,
1194
1195 MAX_IE = 0xFFFF
1196};
1197
1198
1199int wl1271_acx_wake_up_conditions(struct wl1271 *wl, u8 wake_up_event,
1200 u8 listen_interval);
1201int wl1271_acx_sleep_auth(struct wl1271 *wl, u8 sleep_auth);
1202int wl1271_acx_fw_version(struct wl1271 *wl, char *buf, size_t len);
1203int wl1271_acx_tx_power(struct wl1271 *wl, int power);
1204int wl1271_acx_feature_cfg(struct wl1271 *wl);
1205int wl1271_acx_mem_map(struct wl1271 *wl,
1206 struct acx_header *mem_map, size_t len);
1207int wl1271_acx_rx_msdu_life_time(struct wl1271 *wl, u32 life_time);
1208int wl1271_acx_rx_config(struct wl1271 *wl, u32 config, u32 filter);
1209int wl1271_acx_pd_threshold(struct wl1271 *wl);
1210int wl1271_acx_slot(struct wl1271 *wl, enum acx_slot_type slot_time);
Juuso Oikarinenc87dec92009-10-08 21:56:31 +03001211int wl1271_acx_group_address_tbl(struct wl1271 *wl, bool enable,
1212 void *mc_list, u32 mc_list_len);
Luciano Coelhof5fc0f82009-08-06 16:25:28 +03001213int wl1271_acx_service_period_timeout(struct wl1271 *wl);
1214int wl1271_acx_rts_threshold(struct wl1271 *wl, u16 rts_threshold);
Juuso Oikarinen19221672009-10-08 21:56:35 +03001215int wl1271_acx_beacon_filter_opt(struct wl1271 *wl, bool enable_filter);
Luciano Coelhof5fc0f82009-08-06 16:25:28 +03001216int wl1271_acx_beacon_filter_table(struct wl1271 *wl);
Juuso Oikarinen34415232009-10-08 21:56:33 +03001217int wl1271_acx_conn_monit_params(struct wl1271 *wl);
Luciano Coelhof5fc0f82009-08-06 16:25:28 +03001218int wl1271_acx_sg_enable(struct wl1271 *wl);
1219int wl1271_acx_sg_cfg(struct wl1271 *wl);
1220int wl1271_acx_cca_threshold(struct wl1271 *wl);
1221int wl1271_acx_bcn_dtim_options(struct wl1271 *wl);
1222int wl1271_acx_aid(struct wl1271 *wl, u16 aid);
1223int wl1271_acx_event_mbox_mask(struct wl1271 *wl, u32 event_mask);
1224int wl1271_acx_set_preamble(struct wl1271 *wl, enum acx_preamble_type preamble);
1225int wl1271_acx_cts_protect(struct wl1271 *wl,
1226 enum acx_ctsprotect_type ctsprotect);
1227int wl1271_acx_statistics(struct wl1271 *wl, struct acx_statistics *stats);
Juuso Oikarinen8a5a37a2009-10-08 21:56:24 +03001228int wl1271_acx_rate_policies(struct wl1271 *wl, u32 enabled_rates);
Luciano Coelhof5fc0f82009-08-06 16:25:28 +03001229int wl1271_acx_ac_cfg(struct wl1271 *wl);
1230int wl1271_acx_tid_cfg(struct wl1271 *wl);
1231int wl1271_acx_frag_threshold(struct wl1271 *wl);
1232int wl1271_acx_tx_config_options(struct wl1271 *wl);
1233int wl1271_acx_mem_cfg(struct wl1271 *wl);
1234int wl1271_acx_init_mem_config(struct wl1271 *wl);
1235int wl1271_acx_init_rx_interrupt(struct wl1271 *wl);
1236
1237#endif /* __WL1271_ACX_H__ */