xref: /linux/drivers/net/wireless/ti/wlcore/conf.h (revision c532de5a67a70f8533d495f8f2aaa9a0491c3ad0)
1 /* SPDX-License-Identifier: GPL-2.0-only */
2 /*
3  * This file is part of wl1271
4  *
5  * Copyright (C) 2009 Nokia Corporation
6  *
7  * Contact: Luciano Coelho <luciano.coelho@nokia.com>
8  */
9 
10 #ifndef __CONF_H__
11 #define __CONF_H__
12 
13 enum {
14 	CONF_HW_BIT_RATE_1MBPS   = BIT(0),
15 	CONF_HW_BIT_RATE_2MBPS   = BIT(1),
16 	CONF_HW_BIT_RATE_5_5MBPS = BIT(2),
17 	CONF_HW_BIT_RATE_6MBPS   = BIT(3),
18 	CONF_HW_BIT_RATE_9MBPS   = BIT(4),
19 	CONF_HW_BIT_RATE_11MBPS  = BIT(5),
20 	CONF_HW_BIT_RATE_12MBPS  = BIT(6),
21 	CONF_HW_BIT_RATE_18MBPS  = BIT(7),
22 	CONF_HW_BIT_RATE_22MBPS  = BIT(8),
23 	CONF_HW_BIT_RATE_24MBPS  = BIT(9),
24 	CONF_HW_BIT_RATE_36MBPS  = BIT(10),
25 	CONF_HW_BIT_RATE_48MBPS  = BIT(11),
26 	CONF_HW_BIT_RATE_54MBPS  = BIT(12),
27 	CONF_HW_BIT_RATE_MCS_0   = BIT(13),
28 	CONF_HW_BIT_RATE_MCS_1   = BIT(14),
29 	CONF_HW_BIT_RATE_MCS_2   = BIT(15),
30 	CONF_HW_BIT_RATE_MCS_3   = BIT(16),
31 	CONF_HW_BIT_RATE_MCS_4   = BIT(17),
32 	CONF_HW_BIT_RATE_MCS_5   = BIT(18),
33 	CONF_HW_BIT_RATE_MCS_6   = BIT(19),
34 	CONF_HW_BIT_RATE_MCS_7   = BIT(20),
35 	CONF_HW_BIT_RATE_MCS_8   = BIT(21),
36 	CONF_HW_BIT_RATE_MCS_9   = BIT(22),
37 	CONF_HW_BIT_RATE_MCS_10  = BIT(23),
38 	CONF_HW_BIT_RATE_MCS_11  = BIT(24),
39 	CONF_HW_BIT_RATE_MCS_12  = BIT(25),
40 	CONF_HW_BIT_RATE_MCS_13  = BIT(26),
41 	CONF_HW_BIT_RATE_MCS_14  = BIT(27),
42 	CONF_HW_BIT_RATE_MCS_15  = BIT(28),
43 };
44 
45 enum {
46 	CONF_HW_RATE_INDEX_1MBPS      = 0,
47 	CONF_HW_RATE_INDEX_2MBPS      = 1,
48 	CONF_HW_RATE_INDEX_5_5MBPS    = 2,
49 	CONF_HW_RATE_INDEX_11MBPS     = 3,
50 	CONF_HW_RATE_INDEX_6MBPS      = 4,
51 	CONF_HW_RATE_INDEX_9MBPS      = 5,
52 	CONF_HW_RATE_INDEX_12MBPS     = 6,
53 	CONF_HW_RATE_INDEX_18MBPS     = 7,
54 	CONF_HW_RATE_INDEX_24MBPS     = 8,
55 	CONF_HW_RATE_INDEX_36MBPS     = 9,
56 	CONF_HW_RATE_INDEX_48MBPS     = 10,
57 	CONF_HW_RATE_INDEX_54MBPS     = 11,
58 	CONF_HW_RATE_INDEX_MCS0       = 12,
59 	CONF_HW_RATE_INDEX_MCS1       = 13,
60 	CONF_HW_RATE_INDEX_MCS2       = 14,
61 	CONF_HW_RATE_INDEX_MCS3       = 15,
62 	CONF_HW_RATE_INDEX_MCS4       = 16,
63 	CONF_HW_RATE_INDEX_MCS5       = 17,
64 	CONF_HW_RATE_INDEX_MCS6       = 18,
65 	CONF_HW_RATE_INDEX_MCS7       = 19,
66 	CONF_HW_RATE_INDEX_MCS7_SGI   = 20,
67 	CONF_HW_RATE_INDEX_MCS0_40MHZ = 21,
68 	CONF_HW_RATE_INDEX_MCS1_40MHZ = 22,
69 	CONF_HW_RATE_INDEX_MCS2_40MHZ = 23,
70 	CONF_HW_RATE_INDEX_MCS3_40MHZ = 24,
71 	CONF_HW_RATE_INDEX_MCS4_40MHZ = 25,
72 	CONF_HW_RATE_INDEX_MCS5_40MHZ = 26,
73 	CONF_HW_RATE_INDEX_MCS6_40MHZ = 27,
74 	CONF_HW_RATE_INDEX_MCS7_40MHZ = 28,
75 	CONF_HW_RATE_INDEX_MCS7_40MHZ_SGI = 29,
76 
77 	/* MCS8+ rates overlap with 40Mhz rates */
78 	CONF_HW_RATE_INDEX_MCS8       = 21,
79 	CONF_HW_RATE_INDEX_MCS9       = 22,
80 	CONF_HW_RATE_INDEX_MCS10      = 23,
81 	CONF_HW_RATE_INDEX_MCS11      = 24,
82 	CONF_HW_RATE_INDEX_MCS12      = 25,
83 	CONF_HW_RATE_INDEX_MCS13      = 26,
84 	CONF_HW_RATE_INDEX_MCS14      = 27,
85 	CONF_HW_RATE_INDEX_MCS15      = 28,
86 	CONF_HW_RATE_INDEX_MCS15_SGI  = 29,
87 
88 	CONF_HW_RATE_INDEX_MAX        = CONF_HW_RATE_INDEX_MCS7_40MHZ_SGI,
89 };
90 
91 #define CONF_HW_RXTX_RATE_UNSUPPORTED 0xff
92 
93 enum {
94 	CONF_SG_DISABLE = 0,
95 	CONF_SG_PROTECTIVE,
96 	CONF_SG_OPPORTUNISTIC
97 };
98 
99 #define WLCORE_CONF_SG_PARAMS_MAX 67
100 #define WLCORE_CONF_SG_PARAMS_ALL 0xff
101 
102 struct conf_sg_settings {
103 	u32 params[WLCORE_CONF_SG_PARAMS_MAX];
104 	u8 state;
105 } __packed;
106 
107 enum conf_rx_queue_type {
108 	CONF_RX_QUEUE_TYPE_LOW_PRIORITY,  /* All except the high priority */
109 	CONF_RX_QUEUE_TYPE_HIGH_PRIORITY, /* Management and voice packets */
110 };
111 
112 struct conf_rx_settings {
113 	/*
114 	 * The maximum amount of time, in TU, before the
115 	 * firmware discards the MSDU.
116 	 *
117 	 * Range: 0 - 0xFFFFFFFF
118 	 */
119 	u32 rx_msdu_life_time;
120 
121 	/*
122 	 * Packet detection threshold in the PHY.
123 	 *
124 	 * FIXME: details unknown.
125 	 */
126 	u32 packet_detection_threshold;
127 
128 	/*
129 	 * The longest time the STA will wait to receive traffic from the AP
130 	 * after a PS-poll has been transmitted.
131 	 *
132 	 * Range: 0 - 200000
133 	 */
134 	u16 ps_poll_timeout;
135 	/*
136 	 * The longest time the STA will wait to receive traffic from the AP
137 	 * after a frame has been sent from an UPSD enabled queue.
138 	 *
139 	 * Range: 0 - 200000
140 	 */
141 	u16 upsd_timeout;
142 
143 	/*
144 	 * The number of octets in an MPDU, below which an RTS/CTS
145 	 * handshake is not performed.
146 	 *
147 	 * Range: 0 - 4096
148 	 */
149 	u16 rts_threshold;
150 
151 	/*
152 	 * The RX Clear Channel Assessment threshold in the PHY
153 	 * (the energy threshold).
154 	 *
155 	 * Range: ENABLE_ENERGY_D  == 0x140A
156 	 *        DISABLE_ENERGY_D == 0xFFEF
157 	 */
158 	u16 rx_cca_threshold;
159 
160 	/*
161 	 * Occupied Rx mem-blocks number which requires interrupting the host
162 	 * (0 = no buffering, 0xffff = disabled).
163 	 *
164 	 * Range: u16
165 	 */
166 	u16 irq_blk_threshold;
167 
168 	/*
169 	 * Rx packets number which requires interrupting the host
170 	 * (0 = no buffering).
171 	 *
172 	 * Range: u16
173 	 */
174 	u16 irq_pkt_threshold;
175 
176 	/*
177 	 * Max time in msec the FW may delay RX-Complete interrupt.
178 	 *
179 	 * Range: 1 - 100
180 	 */
181 	u16 irq_timeout;
182 
183 	/*
184 	 * The RX queue type.
185 	 *
186 	 * Range: RX_QUEUE_TYPE_RX_LOW_PRIORITY, RX_QUEUE_TYPE_RX_HIGH_PRIORITY,
187 	 */
188 	u8 queue_type;
189 } __packed;
190 
191 #define CONF_TX_MAX_RATE_CLASSES       10
192 
193 #define CONF_TX_RATE_MASK_UNSPECIFIED  0
194 #define CONF_TX_RATE_MASK_BASIC        (CONF_HW_BIT_RATE_1MBPS | \
195 					CONF_HW_BIT_RATE_2MBPS)
196 #define CONF_TX_RATE_RETRY_LIMIT       10
197 
198 /* basic rates for p2p operations (probe req/resp, etc.) */
199 #define CONF_TX_RATE_MASK_BASIC_P2P    CONF_HW_BIT_RATE_6MBPS
200 
201 /*
202  * Rates supported for data packets when operating as STA/AP. Note the absence
203  * of the 22Mbps rate. There is a FW limitation on 12 rates so we must drop
204  * one. The rate dropped is not mandatory under any operating mode.
205  */
206 #define CONF_TX_ENABLED_RATES       (CONF_HW_BIT_RATE_1MBPS |    \
207 	CONF_HW_BIT_RATE_2MBPS | CONF_HW_BIT_RATE_5_5MBPS |      \
208 	CONF_HW_BIT_RATE_6MBPS | CONF_HW_BIT_RATE_9MBPS |        \
209 	CONF_HW_BIT_RATE_11MBPS | CONF_HW_BIT_RATE_12MBPS |      \
210 	CONF_HW_BIT_RATE_18MBPS | CONF_HW_BIT_RATE_24MBPS |      \
211 	CONF_HW_BIT_RATE_36MBPS | CONF_HW_BIT_RATE_48MBPS |      \
212 	CONF_HW_BIT_RATE_54MBPS)
213 
214 #define CONF_TX_CCK_RATES  (CONF_HW_BIT_RATE_1MBPS |		\
215 	CONF_HW_BIT_RATE_2MBPS | CONF_HW_BIT_RATE_5_5MBPS |	\
216 	CONF_HW_BIT_RATE_11MBPS)
217 
218 #define CONF_TX_OFDM_RATES (CONF_HW_BIT_RATE_6MBPS |             \
219 	CONF_HW_BIT_RATE_12MBPS | CONF_HW_BIT_RATE_24MBPS |      \
220 	CONF_HW_BIT_RATE_36MBPS | CONF_HW_BIT_RATE_48MBPS |      \
221 	CONF_HW_BIT_RATE_54MBPS)
222 
223 #define CONF_TX_MCS_RATES (CONF_HW_BIT_RATE_MCS_0 |              \
224 	CONF_HW_BIT_RATE_MCS_1 | CONF_HW_BIT_RATE_MCS_2 |        \
225 	CONF_HW_BIT_RATE_MCS_3 | CONF_HW_BIT_RATE_MCS_4 |        \
226 	CONF_HW_BIT_RATE_MCS_5 | CONF_HW_BIT_RATE_MCS_6 |        \
227 	CONF_HW_BIT_RATE_MCS_7)
228 
229 #define CONF_TX_MIMO_RATES (CONF_HW_BIT_RATE_MCS_8 |             \
230 	CONF_HW_BIT_RATE_MCS_9 | CONF_HW_BIT_RATE_MCS_10 |       \
231 	CONF_HW_BIT_RATE_MCS_11 | CONF_HW_BIT_RATE_MCS_12 |      \
232 	CONF_HW_BIT_RATE_MCS_13 | CONF_HW_BIT_RATE_MCS_14 |      \
233 	CONF_HW_BIT_RATE_MCS_15)
234 
235 /*
236  * Default rates for management traffic when operating in AP mode. This
237  * should be configured according to the basic rate set of the AP
238  */
239 #define CONF_TX_AP_DEFAULT_MGMT_RATES  (CONF_HW_BIT_RATE_1MBPS | \
240 	CONF_HW_BIT_RATE_2MBPS | CONF_HW_BIT_RATE_5_5MBPS)
241 
242 /* default rates for working as IBSS (11b and OFDM) */
243 #define CONF_TX_IBSS_DEFAULT_RATES  (CONF_HW_BIT_RATE_1MBPS |       \
244 		CONF_HW_BIT_RATE_2MBPS | CONF_HW_BIT_RATE_5_5MBPS | \
245 		CONF_HW_BIT_RATE_11MBPS | CONF_TX_OFDM_RATES);
246 
247 struct conf_tx_rate_class {
248 
249 	/*
250 	 * The rates enabled for this rate class.
251 	 *
252 	 * Range: CONF_HW_BIT_RATE_* bit mask
253 	 */
254 	u32 enabled_rates;
255 
256 	/*
257 	 * The dot11 short retry limit used for TX retries.
258 	 *
259 	 * Range: u8
260 	 */
261 	u8 short_retry_limit;
262 
263 	/*
264 	 * The dot11 long retry limit used for TX retries.
265 	 *
266 	 * Range: u8
267 	 */
268 	u8 long_retry_limit;
269 
270 	/*
271 	 * Flags controlling the attributes of TX transmission.
272 	 *
273 	 * Range: bit 0: Truncate - when set, FW attempts to send a frame stop
274 	 *               when the total valid per-rate attempts have
275 	 *               been exhausted; otherwise transmissions
276 	 *               will continue at the lowest available rate
277 	 *               until the appropriate one of the
278 	 *               short_retry_limit, long_retry_limit,
279 	 *               dot11_max_transmit_msdu_life_time, or
280 	 *               max_tx_life_time, is exhausted.
281 	 *            1: Preamble Override - indicates if the preamble type
282 	 *               should be used in TX.
283 	 *            2: Preamble Type - the type of the preamble to be used by
284 	 *               the policy (0 - long preamble, 1 - short preamble.
285 	 */
286 	u8 aflags;
287 } __packed;
288 
289 #define CONF_TX_MAX_AC_COUNT 4
290 
291 /* Slot number setting to start transmission at PIFS interval */
292 #define CONF_TX_AIFS_PIFS 1
293 /* Slot number setting to start transmission at DIFS interval normal
294  * DCF access */
295 #define CONF_TX_AIFS_DIFS 2
296 
297 
298 enum conf_tx_ac {
299 	CONF_TX_AC_BE = 0,         /* best effort / legacy */
300 	CONF_TX_AC_BK = 1,         /* background */
301 	CONF_TX_AC_VI = 2,         /* video */
302 	CONF_TX_AC_VO = 3,         /* voice */
303 	CONF_TX_AC_CTS2SELF = 4,   /* fictitious AC, follows AC_VO */
304 	CONF_TX_AC_ANY_TID = 0xff
305 };
306 
307 struct conf_tx_ac_category {
308 	/*
309 	 * The AC class identifier.
310 	 *
311 	 * Range: enum conf_tx_ac
312 	 */
313 	u8 ac;
314 
315 	/*
316 	 * The contention window minimum size (in slots) for the access
317 	 * class.
318 	 *
319 	 * Range: u8
320 	 */
321 	u8 cw_min;
322 
323 	/*
324 	 * The contention window maximum size (in slots) for the access
325 	 * class.
326 	 *
327 	 * Range: u8
328 	 */
329 	u16 cw_max;
330 
331 	/*
332 	 * The AIF value (in slots) for the access class.
333 	 *
334 	 * Range: u8
335 	 */
336 	u8 aifsn;
337 
338 	/*
339 	 * The TX Op Limit (in microseconds) for the access class.
340 	 *
341 	 * Range: u16
342 	 */
343 	u16 tx_op_limit;
344 } __packed;
345 
346 #define CONF_TX_MAX_TID_COUNT 8
347 
348 /* Allow TX BA on all TIDs but 6,7. These are currently reserved in the FW */
349 #define CONF_TX_BA_ENABLED_TID_BITMAP 0x3F
350 
351 enum {
352 	CONF_CHANNEL_TYPE_DCF = 0,   /* DC/LEGACY*/
353 	CONF_CHANNEL_TYPE_EDCF = 1,  /* EDCA*/
354 	CONF_CHANNEL_TYPE_HCCA = 2,  /* HCCA*/
355 };
356 
357 enum {
358 	CONF_PS_SCHEME_LEGACY = 0,
359 	CONF_PS_SCHEME_UPSD_TRIGGER = 1,
360 	CONF_PS_SCHEME_LEGACY_PSPOLL = 2,
361 	CONF_PS_SCHEME_SAPSD = 3,
362 };
363 
364 enum {
365 	CONF_ACK_POLICY_LEGACY = 0,
366 	CONF_ACK_POLICY_NO_ACK = 1,
367 	CONF_ACK_POLICY_BLOCK = 2,
368 };
369 
370 
371 struct conf_tx_tid {
372 	u8 queue_id;
373 	u8 channel_type;
374 	u8 tsid;
375 	u8 ps_scheme;
376 	u8 ack_policy;
377 	u32 apsd_conf[2];
378 } __packed;
379 
380 struct conf_tx_settings {
381 	/*
382 	 * The TX ED value for TELEC Enable/Disable.
383 	 *
384 	 * Range: 0, 1
385 	 */
386 	u8 tx_energy_detection;
387 
388 	/*
389 	 * Configuration for rate classes for TX (currently only one
390 	 * rate class supported). Used in non-AP mode.
391 	 */
392 	struct conf_tx_rate_class sta_rc_conf;
393 
394 	/*
395 	 * Configuration for access categories for TX rate control.
396 	 */
397 	u8 ac_conf_count;
398 	struct conf_tx_ac_category ac_conf[CONF_TX_MAX_AC_COUNT];
399 
400 	/*
401 	 * AP-mode - allow this number of TX retries to a station before an
402 	 * event is triggered from FW.
403 	 * In AP-mode the hlids of unreachable stations are given in the
404 	 * "sta_tx_retry_exceeded" member in the event mailbox.
405 	 */
406 	u8 max_tx_retries;
407 
408 	/*
409 	 * AP-mode - after this number of seconds a connected station is
410 	 * considered inactive.
411 	 */
412 	u16 ap_aging_period;
413 
414 	/*
415 	 * Configuration for TID parameters.
416 	 */
417 	u8 tid_conf_count;
418 	struct conf_tx_tid tid_conf[CONF_TX_MAX_TID_COUNT];
419 
420 	/*
421 	 * The TX fragmentation threshold.
422 	 *
423 	 * Range: u16
424 	 */
425 	u16 frag_threshold;
426 
427 	/*
428 	 * Max time in msec the FW may delay frame TX-Complete interrupt.
429 	 *
430 	 * Range: u16
431 	 */
432 	u16 tx_compl_timeout;
433 
434 	/*
435 	 * Completed TX packet count which requires to issue the TX-Complete
436 	 * interrupt.
437 	 *
438 	 * Range: u16
439 	 */
440 	u16 tx_compl_threshold;
441 
442 	/*
443 	 * The rate used for control messages and scanning on the 2.4GHz band
444 	 *
445 	 * Range: CONF_HW_BIT_RATE_* bit mask
446 	 */
447 	u32 basic_rate;
448 
449 	/*
450 	 * The rate used for control messages and scanning on the 5GHz band
451 	 *
452 	 * Range: CONF_HW_BIT_RATE_* bit mask
453 	 */
454 	u32 basic_rate_5;
455 
456 	/*
457 	 * TX retry limits for templates
458 	 */
459 	u8 tmpl_short_retry_limit;
460 	u8 tmpl_long_retry_limit;
461 
462 	/* Time in ms for Tx watchdog timer to expire */
463 	u32 tx_watchdog_timeout;
464 
465 	/*
466 	 * when a slow link has this much packets pending, it becomes a low
467 	 * priority link, scheduling-wise
468 	 */
469 	u8 slow_link_thold;
470 
471 	/*
472 	 * when a fast link has this much packets pending, it becomes a low
473 	 * priority link, scheduling-wise
474 	 */
475 	u8 fast_link_thold;
476 } __packed;
477 
478 enum {
479 	CONF_WAKE_UP_EVENT_BEACON    = 0x01, /* Wake on every Beacon*/
480 	CONF_WAKE_UP_EVENT_DTIM      = 0x02, /* Wake on every DTIM*/
481 	CONF_WAKE_UP_EVENT_N_DTIM    = 0x04, /* Wake every Nth DTIM */
482 	CONF_WAKE_UP_EVENT_N_BEACONS = 0x08, /* Wake every Nth beacon */
483 	CONF_WAKE_UP_EVENT_BITS_MASK = 0x0F
484 };
485 
486 #define CONF_MAX_BCN_FILT_IE_COUNT 32
487 
488 #define CONF_BCN_RULE_PASS_ON_CHANGE         BIT(0)
489 #define CONF_BCN_RULE_PASS_ON_APPEARANCE     BIT(1)
490 
491 #define CONF_BCN_IE_OUI_LEN    3
492 #define CONF_BCN_IE_VER_LEN    2
493 
494 struct conf_bcn_filt_rule {
495 	/*
496 	 * IE number to which to associate a rule.
497 	 *
498 	 * Range: u8
499 	 */
500 	u8 ie;
501 
502 	/*
503 	 * Rule to associate with the specific ie.
504 	 *
505 	 * Range: CONF_BCN_RULE_PASS_ON_*
506 	 */
507 	u8 rule;
508 
509 	/*
510 	 * OUI for the vendor specifie IE (221)
511 	 */
512 	u8 oui[CONF_BCN_IE_OUI_LEN];
513 
514 	/*
515 	 * Type for the vendor specifie IE (221)
516 	 */
517 	u8 type;
518 
519 	/*
520 	 * Version for the vendor specifie IE (221)
521 	 */
522 	u8 version[CONF_BCN_IE_VER_LEN];
523 } __packed;
524 
525 #define CONF_MAX_RSSI_SNR_TRIGGERS 8
526 
527 enum {
528 	CONF_TRIG_METRIC_RSSI_BEACON = 0,
529 	CONF_TRIG_METRIC_RSSI_DATA,
530 	CONF_TRIG_METRIC_SNR_BEACON,
531 	CONF_TRIG_METRIC_SNR_DATA
532 };
533 
534 enum {
535 	CONF_TRIG_EVENT_TYPE_LEVEL = 0,
536 	CONF_TRIG_EVENT_TYPE_EDGE
537 };
538 
539 enum {
540 	CONF_TRIG_EVENT_DIR_LOW = 0,
541 	CONF_TRIG_EVENT_DIR_HIGH,
542 	CONF_TRIG_EVENT_DIR_BIDIR
543 };
544 
545 struct conf_sig_weights {
546 
547 	/*
548 	 * RSSI from beacons average weight.
549 	 *
550 	 * Range: u8
551 	 */
552 	u8 rssi_bcn_avg_weight;
553 
554 	/*
555 	 * RSSI from data average weight.
556 	 *
557 	 * Range: u8
558 	 */
559 	u8 rssi_pkt_avg_weight;
560 
561 	/*
562 	 * SNR from beacons average weight.
563 	 *
564 	 * Range: u8
565 	 */
566 	u8 snr_bcn_avg_weight;
567 
568 	/*
569 	 * SNR from data average weight.
570 	 *
571 	 * Range: u8
572 	 */
573 	u8 snr_pkt_avg_weight;
574 } __packed;
575 
576 enum conf_bcn_filt_mode {
577 	CONF_BCN_FILT_MODE_DISABLED = 0,
578 	CONF_BCN_FILT_MODE_ENABLED = 1
579 };
580 
581 enum conf_bet_mode {
582 	CONF_BET_MODE_DISABLE = 0,
583 	CONF_BET_MODE_ENABLE = 1,
584 };
585 
586 struct conf_conn_settings {
587 	/*
588 	 * Firmware wakeup conditions configuration. The host may set only
589 	 * one bit.
590 	 *
591 	 * Range: CONF_WAKE_UP_EVENT_*
592 	 */
593 	u8 wake_up_event;
594 
595 	/*
596 	 * Listen interval for beacons or Dtims.
597 	 *
598 	 * Range: 0 for beacon and Dtim wakeup
599 	 *        1-10 for x Dtims
600 	 *        1-255 for x beacons
601 	 */
602 	u8 listen_interval;
603 
604 	/*
605 	 * Firmware wakeup conditions during suspend
606 	 * Range: CONF_WAKE_UP_EVENT_*
607 	 */
608 	u8 suspend_wake_up_event;
609 
610 	/*
611 	 * Listen interval during suspend.
612 	 * Currently will be in DTIMs (1-10)
613 	 *
614 	 */
615 	u8 suspend_listen_interval;
616 
617 	/*
618 	 * Enable or disable the beacon filtering.
619 	 *
620 	 * Range: CONF_BCN_FILT_MODE_*
621 	 */
622 	u8 bcn_filt_mode;
623 
624 	/*
625 	 * Configure Beacon filter pass-thru rules.
626 	 */
627 	u8 bcn_filt_ie_count;
628 	struct conf_bcn_filt_rule bcn_filt_ie[CONF_MAX_BCN_FILT_IE_COUNT];
629 
630 	/*
631 	 * The number of consecutive beacons to lose, before the firmware
632 	 * becomes out of synch.
633 	 *
634 	 * Range: u32
635 	 */
636 	u32 synch_fail_thold;
637 
638 	/*
639 	 * After out-of-synch, the number of TU's to wait without a further
640 	 * received beacon (or probe response) before issuing the BSS_EVENT_LOSE
641 	 * event.
642 	 *
643 	 * Range: u32
644 	 */
645 	u32 bss_lose_timeout;
646 
647 	/*
648 	 * Beacon receive timeout.
649 	 *
650 	 * Range: u32
651 	 */
652 	u32 beacon_rx_timeout;
653 
654 	/*
655 	 * Broadcast receive timeout.
656 	 *
657 	 * Range: u32
658 	 */
659 	u32 broadcast_timeout;
660 
661 	/*
662 	 * Enable/disable reception of broadcast packets in power save mode
663 	 *
664 	 * Range: 1 - enable, 0 - disable
665 	 */
666 	u8 rx_broadcast_in_ps;
667 
668 	/*
669 	 * Consecutive PS Poll failures before sending event to driver
670 	 *
671 	 * Range: u8
672 	 */
673 	u8 ps_poll_threshold;
674 
675 	/*
676 	 * Configuration of signal average weights.
677 	 */
678 	struct conf_sig_weights sig_weights;
679 
680 	/*
681 	 * Specifies if beacon early termination procedure is enabled or
682 	 * disabled.
683 	 *
684 	 * Range: CONF_BET_MODE_*
685 	 */
686 	u8 bet_enable;
687 
688 	/*
689 	 * Specifies the maximum number of consecutive beacons that may be
690 	 * early terminated. After this number is reached at least one full
691 	 * beacon must be correctly received in FW before beacon ET
692 	 * resumes.
693 	 *
694 	 * Range 0 - 255
695 	 */
696 	u8 bet_max_consecutive;
697 
698 	/*
699 	 * Specifies the maximum number of times to try PSM entry if it fails
700 	 * (if sending the appropriate null-func message fails.)
701 	 *
702 	 * Range 0 - 255
703 	 */
704 	u8 psm_entry_retries;
705 
706 	/*
707 	 * Specifies the maximum number of times to try PSM exit if it fails
708 	 * (if sending the appropriate null-func message fails.)
709 	 *
710 	 * Range 0 - 255
711 	 */
712 	u8 psm_exit_retries;
713 
714 	/*
715 	 * Specifies the maximum number of times to try transmit the PSM entry
716 	 * null-func frame for each PSM entry attempt
717 	 *
718 	 * Range 0 - 255
719 	 */
720 	u8 psm_entry_nullfunc_retries;
721 
722 	/*
723 	 * Specifies the dynamic PS timeout in ms that will be used
724 	 * by the FW when in AUTO_PS mode
725 	 */
726 	u16 dynamic_ps_timeout;
727 
728 	/*
729 	 * Specifies whether dynamic PS should be disabled and PSM forced.
730 	 * This is required for certain WiFi certification tests.
731 	 */
732 	u8 forced_ps;
733 
734 	/*
735 	 *
736 	 * Specifies the interval of the connection keep-alive null-func
737 	 * frame in ms.
738 	 *
739 	 * Range: 1000 - 3600000
740 	 */
741 	u32 keep_alive_interval;
742 
743 	/*
744 	 * Maximum listen interval supported by the driver in units of beacons.
745 	 *
746 	 * Range: u16
747 	 */
748 	u8 max_listen_interval;
749 
750 	/*
751 	 * Default sleep authorization for a new STA interface. This determines
752 	 * whether we can go to ELP.
753 	 */
754 	u8 sta_sleep_auth;
755 
756 	/*
757 	 * Default RX BA Activity filter configuration
758 	 */
759 	u8 suspend_rx_ba_activity;
760 } __packed;
761 
762 enum {
763 	CONF_REF_CLK_19_2_E,
764 	CONF_REF_CLK_26_E,
765 	CONF_REF_CLK_38_4_E,
766 	CONF_REF_CLK_52_E,
767 	CONF_REF_CLK_38_4_M_XTAL,
768 	CONF_REF_CLK_26_M_XTAL,
769 };
770 
771 enum single_dual_band_enum {
772 	CONF_SINGLE_BAND,
773 	CONF_DUAL_BAND
774 };
775 
776 #define CONF_RSSI_AND_PROCESS_COMPENSATION_SIZE 15
777 #define CONF_NUMBER_OF_SUB_BANDS_5  7
778 #define CONF_NUMBER_OF_RATE_GROUPS  6
779 #define CONF_NUMBER_OF_CHANNELS_2_4 14
780 #define CONF_NUMBER_OF_CHANNELS_5   35
781 
782 struct conf_itrim_settings {
783 	/* enable dco itrim */
784 	u8 enable;
785 
786 	/* moderation timeout in microsecs from the last TX */
787 	u32 timeout;
788 } __packed;
789 
790 enum conf_fast_wakeup {
791 	CONF_FAST_WAKEUP_ENABLE,
792 	CONF_FAST_WAKEUP_DISABLE,
793 };
794 
795 struct conf_pm_config_settings {
796 	/*
797 	 * Host clock settling time
798 	 *
799 	 * Range: 0 - 30000 us
800 	 */
801 	u32 host_clk_settling_time;
802 
803 	/*
804 	 * Host fast wakeup support
805 	 *
806 	 * Range: enum conf_fast_wakeup
807 	 */
808 	u8 host_fast_wakeup_support;
809 } __packed;
810 
811 struct conf_roam_trigger_settings {
812 	/*
813 	 * The minimum interval between two trigger events.
814 	 *
815 	 * Range: 0 - 60000 ms
816 	 */
817 	u16 trigger_pacing;
818 
819 	/*
820 	 * The weight for rssi/beacon average calculation
821 	 *
822 	 * Range: 0 - 255
823 	 */
824 	u8 avg_weight_rssi_beacon;
825 
826 	/*
827 	 * The weight for rssi/data frame average calculation
828 	 *
829 	 * Range: 0 - 255
830 	 */
831 	u8 avg_weight_rssi_data;
832 
833 	/*
834 	 * The weight for snr/beacon average calculation
835 	 *
836 	 * Range: 0 - 255
837 	 */
838 	u8 avg_weight_snr_beacon;
839 
840 	/*
841 	 * The weight for snr/data frame average calculation
842 	 *
843 	 * Range: 0 - 255
844 	 */
845 	u8 avg_weight_snr_data;
846 } __packed;
847 
848 struct conf_scan_settings {
849 	/*
850 	 * The minimum time to wait on each channel for active scans
851 	 * This value will be used whenever there's a connected interface.
852 	 *
853 	 * Range: u32 tu/1000
854 	 */
855 	u32 min_dwell_time_active;
856 
857 	/*
858 	 * The maximum time to wait on each channel for active scans
859 	 * This value will be currently used whenever there's a
860 	 * connected interface. It shouldn't exceed 30000 (~30ms) to avoid
861 	 * possible interference of voip traffic going on while scanning.
862 	 *
863 	 * Range: u32 tu/1000
864 	 */
865 	u32 max_dwell_time_active;
866 
867 	/* The minimum time to wait on each channel for active scans
868 	 * when it's possible to have longer scan dwell times.
869 	 * Currently this is used whenever we're idle on all interfaces.
870 	 * Longer dwell times improve detection of networks within a
871 	 * single scan.
872 	 *
873 	 * Range: u32 tu/1000
874 	 */
875 	u32 min_dwell_time_active_long;
876 
877 	/* The maximum time to wait on each channel for active scans
878 	 * when it's possible to have longer scan dwell times.
879 	 * See min_dwell_time_active_long
880 	 *
881 	 * Range: u32 tu/1000
882 	 */
883 	u32 max_dwell_time_active_long;
884 
885 	/* time to wait on the channel for passive scans (in TU/1000) */
886 	u32 dwell_time_passive;
887 
888 	/* time to wait on the channel for DFS scans (in TU/1000) */
889 	u32 dwell_time_dfs;
890 
891 	/*
892 	 * Number of probe requests to transmit on each active scan channel
893 	 *
894 	 * Range: u8
895 	 */
896 	u16 num_probe_reqs;
897 
898 	/*
899 	 * Scan trigger (split scan) timeout. The FW will split the scan
900 	 * operation into slices of the given time and allow the FW to schedule
901 	 * other tasks in between.
902 	 *
903 	 * Range: u32 Microsecs
904 	 */
905 	u32 split_scan_timeout;
906 } __packed;
907 
908 struct conf_sched_scan_settings {
909 	/*
910 	 * The base time to wait on the channel for active scans (in TU/1000).
911 	 * The minimum dwell time is calculated according to this:
912 	 * min_dwell_time = base + num_of_probes_to_be_sent * delta_per_probe
913 	 * The maximum dwell time is calculated according to this:
914 	 * max_dwell_time = min_dwell_time + max_dwell_time_delta
915 	 */
916 	u32 base_dwell_time;
917 
918 	/* The delta between the min dwell time and max dwell time for
919 	 * active scans (in TU/1000s). The max dwell time is used by the FW once
920 	 * traffic is detected on the channel.
921 	 */
922 	u32 max_dwell_time_delta;
923 
924 	/* Delta added to min dwell time per each probe in 2.4 GHz (TU/1000) */
925 	u32 dwell_time_delta_per_probe;
926 
927 	/* Delta added to min dwell time per each probe in 5 GHz (TU/1000) */
928 	u32 dwell_time_delta_per_probe_5;
929 
930 	/* time to wait on the channel for passive scans (in TU/1000) */
931 	u32 dwell_time_passive;
932 
933 	/* time to wait on the channel for DFS scans (in TU/1000) */
934 	u32 dwell_time_dfs;
935 
936 	/* number of probe requests to send on each channel in active scans */
937 	u8 num_probe_reqs;
938 
939 	/* RSSI threshold to be used for filtering */
940 	s8 rssi_threshold;
941 
942 	/* SNR threshold to be used for filtering */
943 	s8 snr_threshold;
944 
945 	/*
946 	 * number of short intervals scheduled scan cycles before
947 	 * switching to long intervals
948 	 */
949 	u8 num_short_intervals;
950 
951 	/* interval between each long scheduled scan cycle (in ms) */
952 	u16 long_interval;
953 } __packed;
954 
955 struct conf_ht_setting {
956 	u8 rx_ba_win_size;
957 	u8 tx_ba_win_size;
958 	u16 inactivity_timeout;
959 
960 	/* bitmap of enabled TIDs for TX BA sessions */
961 	u8 tx_ba_tid_bitmap;
962 } __packed;
963 
964 struct conf_memory_settings {
965 	/* Number of stations supported in IBSS mode */
966 	u8 num_stations;
967 
968 	/* Number of ssid profiles used in IBSS mode */
969 	u8 ssid_profiles;
970 
971 	/* Number of memory buffers allocated to rx pool */
972 	u8 rx_block_num;
973 
974 	/* Minimum number of blocks allocated to tx pool */
975 	u8 tx_min_block_num;
976 
977 	/* Disable/Enable dynamic memory */
978 	u8 dynamic_memory;
979 
980 	/*
981 	 * Minimum required free tx memory blocks in order to assure optimum
982 	 * performance
983 	 *
984 	 * Range: 0-120
985 	 */
986 	u8 min_req_tx_blocks;
987 
988 	/*
989 	 * Minimum required free rx memory blocks in order to assure optimum
990 	 * performance
991 	 *
992 	 * Range: 0-120
993 	 */
994 	u8 min_req_rx_blocks;
995 
996 	/*
997 	 * Minimum number of mem blocks (free+used) guaranteed for TX
998 	 *
999 	 * Range: 0-120
1000 	 */
1001 	u8 tx_min;
1002 } __packed;
1003 
1004 struct conf_fm_coex {
1005 	u8 enable;
1006 	u8 swallow_period;
1007 	u8 n_divider_fref_set_1;
1008 	u8 n_divider_fref_set_2;
1009 	u16 m_divider_fref_set_1;
1010 	u16 m_divider_fref_set_2;
1011 	u32 coex_pll_stabilization_time;
1012 	u16 ldo_stabilization_time;
1013 	u8 fm_disturbed_band_margin;
1014 	u8 swallow_clk_diff;
1015 } __packed;
1016 
1017 struct conf_rx_streaming_settings {
1018 	/*
1019 	 * RX Streaming duration (in msec) from last tx/rx
1020 	 *
1021 	 * Range: u32
1022 	 */
1023 	u32 duration;
1024 
1025 	/*
1026 	 * Bitmap of tids to be polled during RX streaming.
1027 	 * (Note: it doesn't look like it really matters)
1028 	 *
1029 	 * Range: 0x1-0xff
1030 	 */
1031 	u8 queues;
1032 
1033 	/*
1034 	 * RX Streaming interval.
1035 	 * (Note:this value is also used as the rx streaming timeout)
1036 	 * Range: 0 (disabled), 10 - 100
1037 	 */
1038 	u8 interval;
1039 
1040 	/*
1041 	 * enable rx streaming also when there is no coex activity
1042 	 */
1043 	u8 always;
1044 } __packed;
1045 
1046 #define CONF_FWLOG_MIN_MEM_BLOCKS	2
1047 #define CONF_FWLOG_MAX_MEM_BLOCKS	16
1048 
1049 struct conf_fwlog {
1050 	/* Continuous or on-demand */
1051 	u8 mode;
1052 
1053 	/*
1054 	 * Number of memory blocks dedicated for the FW logger
1055 	 *
1056 	 * Range: 2-16, or 0 to disable the FW logger
1057 	 */
1058 	u8 mem_blocks;
1059 
1060 	/* Minimum log level threshold */
1061 	u8 severity;
1062 
1063 	/* Include/exclude timestamps from the log messages */
1064 	u8 timestamp;
1065 
1066 	/* See enum wl1271_fwlogger_output */
1067 	u8 output;
1068 
1069 	/* Regulates the frequency of log messages */
1070 	u8 threshold;
1071 } __packed;
1072 
1073 #define ACX_RATE_MGMT_NUM_OF_RATES 13
1074 struct conf_rate_policy_settings {
1075 	u16 rate_retry_score;
1076 	u16 per_add;
1077 	u16 per_th1;
1078 	u16 per_th2;
1079 	u16 max_per;
1080 	u8 inverse_curiosity_factor;
1081 	u8 tx_fail_low_th;
1082 	u8 tx_fail_high_th;
1083 	u8 per_alpha_shift;
1084 	u8 per_add_shift;
1085 	u8 per_beta1_shift;
1086 	u8 per_beta2_shift;
1087 	u8 rate_check_up;
1088 	u8 rate_check_down;
1089 	u8 rate_retry_policy[ACX_RATE_MGMT_NUM_OF_RATES];
1090 } __packed;
1091 
1092 struct conf_hangover_settings {
1093 	u32 recover_time;
1094 	u8 hangover_period;
1095 	u8 dynamic_mode;
1096 	u8 early_termination_mode;
1097 	u8 max_period;
1098 	u8 min_period;
1099 	u8 increase_delta;
1100 	u8 decrease_delta;
1101 	u8 quiet_time;
1102 	u8 increase_time;
1103 	u8 window_size;
1104 } __packed;
1105 
1106 struct conf_recovery_settings {
1107 	/* BUG() on fw recovery */
1108 	u8 bug_on_recovery;
1109 
1110 	/* Prevent HW recovery. FW will remain stuck. */
1111 	u8 no_recovery;
1112 } __packed;
1113 
1114 /*
1115  * The conf version consists of 4 bytes.  The two MSB are the wlcore
1116  * version, the two LSB are the lower driver's private conf
1117  * version.
1118  */
1119 #define WLCORE_CONF_VERSION	(0x0007 << 16)
1120 #define WLCORE_CONF_MASK	0xffff0000
1121 #define WLCORE_CONF_SIZE	(sizeof(struct wlcore_conf_header) +	\
1122 				 sizeof(struct wlcore_conf))
1123 
1124 struct wlcore_conf_header {
1125 	__le32 magic;
1126 	__le32 version;
1127 	__le32 checksum;
1128 } __packed;
1129 
1130 struct wlcore_conf {
1131 	struct conf_sg_settings sg;
1132 	struct conf_rx_settings rx;
1133 	struct conf_tx_settings tx;
1134 	struct conf_conn_settings conn;
1135 	struct conf_itrim_settings itrim;
1136 	struct conf_pm_config_settings pm_config;
1137 	struct conf_roam_trigger_settings roam_trigger;
1138 	struct conf_scan_settings scan;
1139 	struct conf_sched_scan_settings sched_scan;
1140 	struct conf_ht_setting ht;
1141 	struct conf_memory_settings mem;
1142 	struct conf_fm_coex fm_coex;
1143 	struct conf_rx_streaming_settings rx_streaming;
1144 	struct conf_fwlog fwlog;
1145 	struct conf_rate_policy_settings rate;
1146 	struct conf_hangover_settings hangover;
1147 	struct conf_recovery_settings recovery;
1148 } __packed;
1149 
1150 struct wlcore_conf_file {
1151 	struct wlcore_conf_header header;
1152 	struct wlcore_conf core;
1153 	u8 priv[];
1154 } __packed;
1155 
1156 #endif
1157