2 * This file is part of wl1271
4 * Copyright (C) 2009 Nokia Corporation
6 * Contact: Luciano Coelho <luciano.coelho@nokia.com>
8 * This program is free software; you can redistribute it and/or
9 * modify it under the terms of the GNU General Public License
10 * version 2 as published by the Free Software Foundation.
12 * This program is distributed in the hope that it will be useful, but
13 * WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
15 * General Public License for more details.
17 * You should have received a copy of the GNU General Public License
18 * along with this program; if not, write to the Free Software
19 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
24 #ifndef __WL1271_CONF_H__
25 #define __WL1271_CONF_H__
28 CONF_HW_BIT_RATE_1MBPS = BIT(0),
29 CONF_HW_BIT_RATE_2MBPS = BIT(1),
30 CONF_HW_BIT_RATE_5_5MBPS = BIT(2),
31 CONF_HW_BIT_RATE_6MBPS = BIT(3),
32 CONF_HW_BIT_RATE_9MBPS = BIT(4),
33 CONF_HW_BIT_RATE_11MBPS = BIT(5),
34 CONF_HW_BIT_RATE_12MBPS = BIT(6),
35 CONF_HW_BIT_RATE_18MBPS = BIT(7),
36 CONF_HW_BIT_RATE_22MBPS = BIT(8),
37 CONF_HW_BIT_RATE_24MBPS = BIT(9),
38 CONF_HW_BIT_RATE_36MBPS = BIT(10),
39 CONF_HW_BIT_RATE_48MBPS = BIT(11),
40 CONF_HW_BIT_RATE_54MBPS = BIT(12),
41 CONF_HW_BIT_RATE_MCS_0 = BIT(13),
42 CONF_HW_BIT_RATE_MCS_1 = BIT(14),
43 CONF_HW_BIT_RATE_MCS_2 = BIT(15),
44 CONF_HW_BIT_RATE_MCS_3 = BIT(16),
45 CONF_HW_BIT_RATE_MCS_4 = BIT(17),
46 CONF_HW_BIT_RATE_MCS_5 = BIT(18),
47 CONF_HW_BIT_RATE_MCS_6 = BIT(19),
48 CONF_HW_BIT_RATE_MCS_7 = BIT(20)
52 CONF_HW_RATE_INDEX_1MBPS = 0,
53 CONF_HW_RATE_INDEX_2MBPS = 1,
54 CONF_HW_RATE_INDEX_5_5MBPS = 2,
55 CONF_HW_RATE_INDEX_6MBPS = 3,
56 CONF_HW_RATE_INDEX_9MBPS = 4,
57 CONF_HW_RATE_INDEX_11MBPS = 5,
58 CONF_HW_RATE_INDEX_12MBPS = 6,
59 CONF_HW_RATE_INDEX_18MBPS = 7,
60 CONF_HW_RATE_INDEX_22MBPS = 8,
61 CONF_HW_RATE_INDEX_24MBPS = 9,
62 CONF_HW_RATE_INDEX_36MBPS = 10,
63 CONF_HW_RATE_INDEX_48MBPS = 11,
64 CONF_HW_RATE_INDEX_54MBPS = 12,
65 CONF_HW_RATE_INDEX_MAX = CONF_HW_RATE_INDEX_54MBPS,
68 struct conf_sg_settings {
70 * Defines the PER threshold in PPM of the BT voice of which reaching
71 * this value will trigger raising the priority of the BT voice by
72 * the BT IP until next NFS sample interval time as defined in
73 * nfs_sample_interval.
75 * Unit: PER value in PPM (parts per million)
76 * #Error_packets / #Total_packets
83 * This value is an absolute time in micro-seconds to limit the
84 * maximum scan duration compensation while in SG
86 u32 max_scan_compensation_time;
88 /* Defines the PER threshold of the BT voice of which reaching this
89 * value will trigger raising the priority of the BT voice until next
90 * NFS sample interval time as defined in sample_interval.
95 u16 nfs_sample_interval;
98 * Defines the load ratio for the BT.
99 * The WLAN ratio is: 100 - load_ratio
107 * true - Co-ex is allowed to enter/exit P.S automatically and
108 * transparently to the host
110 * false - Co-ex is disallowed to enter/exit P.S and will trigger an
111 * event to the host to notify for the need to enter/exit P.S
112 * due to BT change state
118 * This parameter defines the compensation percentage of num of probe
119 * requests in case scan is initiated during BT voice/BT ACL
123 * Range: 0-255 (0 - No compensation)
125 u8 probe_req_compensation;
128 * This parameter defines the compensation percentage of scan window
129 * size in case scan is initiated during BT voice/BT ACL Guaranteed
133 * Range: 0-255 (0 - No compensation)
135 u8 scan_window_compensation;
138 * Defines the antenna configuration.
140 * Range: 0 - Single Antenna; 1 - Dual Antenna
145 * The percent out of the Max consecutive beacon miss roaming trigger
146 * which is the threshold for raising the priority of beacon
150 * N = MaxConsecutiveBeaconMiss
151 * P = coexMaxConsecutiveBeaconMissPrecent
152 * Threshold = MIN( N-1, round(N * P / 100))
154 u8 beacon_miss_threshold;
157 * The RX rate threshold below which rate adaptation is assumed to be
158 * occurring at the AP which will raise priority for ACTIVE_RX and RX
161 * Range: HW_BIT_RATE_*
163 u32 rate_adaptation_threshold;
166 * The SNR above which the RX rate threshold indicating AP rate
167 * adaptation is valid
171 s8 rate_adaptation_snr;
174 enum conf_rx_queue_type {
175 CONF_RX_QUEUE_TYPE_LOW_PRIORITY, /* All except the high priority */
176 CONF_RX_QUEUE_TYPE_HIGH_PRIORITY, /* Management and voice packets */
179 struct conf_rx_settings {
181 * The maximum amount of time, in TU, before the
182 * firmware discards the MSDU.
184 * Range: 0 - 0xFFFFFFFF
186 u32 rx_msdu_life_time;
189 * Packet detection threshold in the PHY.
191 * FIXME: details unknown.
193 u32 packet_detection_threshold;
196 * The longest time the STA will wait to receive traffic from the AP
197 * after a PS-poll has been transmitted.
203 * The longest time the STA will wait to receive traffic from the AP
204 * after a frame has been sent from an UPSD enabled queue.
211 * The number of octets in an MPDU, below which an RTS/CTS
212 * handshake is not performed.
219 * The RX Clear Channel Assessment threshold in the PHY
220 * (the energy threshold).
222 * Range: ENABLE_ENERGY_D == 0x140A
223 * DISABLE_ENERGY_D == 0xFFEF
225 u16 rx_cca_threshold;
228 * Occupied Rx mem-blocks number which requires interrupting the host
229 * (0 = no buffering, 0xffff = disabled).
233 u16 irq_blk_threshold;
236 * Rx packets number which requires interrupting the host
237 * (0 = no buffering).
241 u16 irq_pkt_threshold;
244 * Max time in msec the FW may delay RX-Complete interrupt.
253 * Range: RX_QUEUE_TYPE_RX_LOW_PRIORITY, RX_QUEUE_TYPE_RX_HIGH_PRIORITY,
258 #define CONF_TX_MAX_RATE_CLASSES 8
260 #define CONF_TX_RATE_MASK_UNSPECIFIED 0
261 #define CONF_TX_RATE_MASK_ALL 0x1eff
262 #define CONF_TX_RATE_RETRY_LIMIT 10
264 struct conf_tx_rate_class {
267 * The rates enabled for this rate class.
269 * Range: CONF_HW_BIT_RATE_* bit mask
274 * The dot11 short retry limit used for TX retries.
278 u8 short_retry_limit;
281 * The dot11 long retry limit used for TX retries.
288 * Flags controlling the attributes of TX transmission.
290 * Range: bit 0: Truncate - when set, FW attempts to send a frame stop
291 * when the total valid per-rate attempts have
292 * been exhausted; otherwise transmissions
293 * will continue at the lowest available rate
294 * until the appropriate one of the
295 * short_retry_limit, long_retry_limit,
296 * dot11_max_transmit_msdu_life_time, or
297 * max_tx_life_time, is exhausted.
298 * 1: Preamble Override - indicates if the preamble type
299 * should be used in TX.
300 * 2: Preamble Type - the type of the preamble to be used by
301 * the policy (0 - long preamble, 1 - short preamble.
306 #define CONF_TX_MAX_AC_COUNT 4
308 /* Slot number setting to start transmission at PIFS interval */
309 #define CONF_TX_AIFS_PIFS 1
310 /* Slot number setting to start transmission at DIFS interval normal
312 #define CONF_TX_AIFS_DIFS 2
316 CONF_TX_AC_BE = 0, /* best effort / legacy */
317 CONF_TX_AC_BK = 1, /* background */
318 CONF_TX_AC_VI = 2, /* video */
319 CONF_TX_AC_VO = 3, /* voice */
320 CONF_TX_AC_CTS2SELF = 4, /* fictious AC, follows AC_VO */
321 CONF_TX_AC_ANY_TID = 0x1f
324 struct conf_tx_ac_category {
326 * The AC class identifier.
328 * Range: enum conf_tx_ac
333 * The contention window minimum size (in slots) for the access
341 * The contention window maximum size (in slots) for the access
349 * The AIF value (in slots) for the access class.
356 * The TX Op Limit (in microseconds) for the access class.
363 #define CONF_TX_MAX_TID_COUNT 7
366 CONF_CHANNEL_TYPE_DCF = 0, /* DC/LEGACY*/
367 CONF_CHANNEL_TYPE_EDCF = 1, /* EDCA*/
368 CONF_CHANNEL_TYPE_HCCA = 2, /* HCCA*/
372 CONF_PS_SCHEME_LEGACY = 0,
373 CONF_PS_SCHEME_UPSD_TRIGGER = 1,
374 CONF_PS_SCHEME_LEGACY_PSPOLL = 2,
375 CONF_PS_SCHEME_SAPSD = 3,
379 CONF_ACK_POLICY_LEGACY = 0,
380 CONF_ACK_POLICY_NO_ACK = 1,
381 CONF_ACK_POLICY_BLOCK = 2,
394 struct conf_tx_settings {
396 * The TX ED value for TELEC Enable/Disable.
400 u8 tx_energy_detection;
403 * Configuration for rate classes for TX (currently only one
404 * rate class supported.)
406 struct conf_tx_rate_class rc_conf;
409 * Configuration for access categories for TX rate control.
412 struct conf_tx_ac_category ac_conf[CONF_TX_MAX_AC_COUNT];
415 * Configuration for TID parameters.
418 struct conf_tx_tid tid_conf[CONF_TX_MAX_TID_COUNT];
421 * The TX fragmentation threshold.
428 * Max time in msec the FW may delay frame TX-Complete interrupt.
432 u16 tx_compl_timeout;
435 * Completed TX packet count which requires to issue the TX-Complete
440 u16 tx_compl_threshold;
445 CONF_WAKE_UP_EVENT_BEACON = 0x01, /* Wake on every Beacon*/
446 CONF_WAKE_UP_EVENT_DTIM = 0x02, /* Wake on every DTIM*/
447 CONF_WAKE_UP_EVENT_N_DTIM = 0x04, /* Wake every Nth DTIM */
448 CONF_WAKE_UP_EVENT_N_BEACONS = 0x08, /* Wake every Nth beacon */
449 CONF_WAKE_UP_EVENT_BITS_MASK = 0x0F
452 #define CONF_MAX_BCN_FILT_IE_COUNT 32
454 #define CONF_BCN_RULE_PASS_ON_CHANGE BIT(0)
455 #define CONF_BCN_RULE_PASS_ON_APPEARANCE BIT(1)
457 #define CONF_BCN_IE_OUI_LEN 3
458 #define CONF_BCN_IE_VER_LEN 2
460 struct conf_bcn_filt_rule {
462 * IE number to which to associate a rule.
469 * Rule to associate with the specific ie.
471 * Range: CONF_BCN_RULE_PASS_ON_*
476 * OUI for the vendor specifie IE (221)
478 u8 oui[CONF_BCN_IE_OUI_LEN];
481 * Type for the vendor specifie IE (221)
486 * Version for the vendor specifie IE (221)
488 u8 version[CONF_BCN_IE_VER_LEN];
491 #define CONF_MAX_RSSI_SNR_TRIGGERS 8
494 CONF_TRIG_METRIC_RSSI_BEACON = 0,
495 CONF_TRIG_METRIC_RSSI_DATA,
496 CONF_TRIG_METRIC_SNR_BEACON,
497 CONF_TRIG_METRIC_SNR_DATA
501 CONF_TRIG_EVENT_TYPE_LEVEL = 0,
502 CONF_TRIG_EVENT_TYPE_EDGE
506 CONF_TRIG_EVENT_DIR_LOW = 0,
507 CONF_TRIG_EVENT_DIR_HIGH,
508 CONF_TRIG_EVENT_DIR_BIDIR
512 struct conf_sig_trigger {
514 * The RSSI / SNR threshold value.
516 * FIXME: what is the range?
521 * Minimum delay between two trigger events for this trigger in ms.
528 * The measurement data source for this trigger.
530 * Range: CONF_TRIG_METRIC_*
535 * The trigger type of this trigger.
537 * Range: CONF_TRIG_EVENT_TYPE_*
542 * The direction of the trigger.
544 * Range: CONF_TRIG_EVENT_DIR_*
549 * Hysteresis range of the trigger around the threshold (in dB)
556 * Index of the trigger rule.
558 * Range: 0 - CONF_MAX_RSSI_SNR_TRIGGERS-1
563 * Enable / disable this rule (to use for clearing rules.)
565 * Range: 1 - Enabled, 2 - Not enabled
570 struct conf_sig_weights {
573 * RSSI from beacons average weight.
577 u8 rssi_bcn_avg_weight;
580 * RSSI from data average weight.
584 u8 rssi_pkt_avg_weight;
587 * SNR from beacons average weight.
591 u8 snr_bcn_avg_weight;
594 * SNR from data average weight.
598 u8 snr_pkt_avg_weight;
601 enum conf_bcn_filt_mode {
602 CONF_BCN_FILT_MODE_DISABLED = 0,
603 CONF_BCN_FILT_MODE_ENABLED = 1
607 CONF_BET_MODE_DISABLE = 0,
608 CONF_BET_MODE_ENABLE = 1,
611 struct conf_conn_settings {
613 * Firmware wakeup conditions configuration. The host may set only
616 * Range: CONF_WAKE_UP_EVENT_*
621 * Listen interval for beacons or Dtims.
623 * Range: 0 for beacon and Dtim wakeup
625 * 1-255 for x beacons
630 * Enable or disable the beacon filtering.
632 * Range: CONF_BCN_FILT_MODE_*
634 enum conf_bcn_filt_mode bcn_filt_mode;
637 * Configure Beacon filter pass-thru rules.
639 u8 bcn_filt_ie_count;
640 struct conf_bcn_filt_rule bcn_filt_ie[CONF_MAX_BCN_FILT_IE_COUNT];
643 * The number of consequtive beacons to lose, before the firmware
644 * becomes out of synch.
648 u32 synch_fail_thold;
651 * After out-of-synch, the number of TU's to wait without a further
652 * received beacon (or probe response) before issuing the BSS_EVENT_LOSE
657 u32 bss_lose_timeout;
660 * Beacon receive timeout.
664 u32 beacon_rx_timeout;
667 * Broadcast receive timeout.
671 u32 broadcast_timeout;
674 * Enable/disable reception of broadcast packets in power save mode
676 * Range: 1 - enable, 0 - disable
678 u8 rx_broadcast_in_ps;
681 * Consequtive PS Poll failures before sending event to driver
685 u8 ps_poll_threshold;
688 * Configuration of signal (rssi/snr) triggers.
690 u8 sig_trigger_count;
691 struct conf_sig_trigger sig_trigger[CONF_MAX_RSSI_SNR_TRIGGERS];
694 * Configuration of signal average weights.
696 struct conf_sig_weights sig_weights;
699 * Specifies if beacon early termination procedure is enabled or
702 * Range: CONF_BET_MODE_*
707 * Specifies the maximum number of consecutive beacons that may be
708 * early terminated. After this number is reached at least one full
709 * beacon must be correctly received in FW before beacon ET
714 u8 bet_max_consecutive;
717 * Specifies the maximum number of times to try PSM entry if it fails
718 * (if sending the appropriate null-func message fails.)
722 u8 psm_entry_retries;
732 enum single_dual_band_enum {
738 #define CONF_MAX_SMART_REFLEX_PARAMS 16
740 struct conf_general_parms {
742 * RF Reference Clock type / speed
744 * Range: CONF_REF_CLK_*
749 * Settling time of the reference clock after boot.
756 * Flag defining whether clock is valid on wakeup.
758 * Range: 0 - not valid on wakeup, 1 - valid on wakeup
760 u8 clk_valid_on_wakeup;
770 * Flag defining whether used as single or dual-band.
772 * Range: CONF_SINGLE_BAND, CONF_DUAL_BAND
777 * TX bip fem autodetect flag.
781 u8 tx_bip_fem_autodetect;
784 * TX bip gem manufacturer.
788 u8 tx_bip_fem_manufacturer;
797 /* Smart reflex settings */
800 s8 srf1[CONF_MAX_SMART_REFLEX_PARAMS];
801 s8 srf2[CONF_MAX_SMART_REFLEX_PARAMS];
802 s8 srf3[CONF_MAX_SMART_REFLEX_PARAMS];
804 s8 sr_debug_table[CONF_MAX_SMART_REFLEX_PARAMS];
812 #define CONF_RSSI_AND_PROCESS_COMPENSATION_SIZE 15
813 #define CONF_NUMBER_OF_SUB_BANDS_5 7
814 #define CONF_NUMBER_OF_RATE_GROUPS 6
815 #define CONF_NUMBER_OF_CHANNELS_2_4 14
816 #define CONF_NUMBER_OF_CHANNELS_5 35
818 struct conf_radio_parms {
820 * Static radio parameters for 2.4GHz
826 s8 rx_rssi_and_proc_compens[CONF_RSSI_AND_PROCESS_COMPENSATION_SIZE];
829 * Static radio parameters for 5GHz
833 u8 rx_trace_loss_5[CONF_NUMBER_OF_SUB_BANDS_5];
834 u8 tx_trace_loss_5[CONF_NUMBER_OF_SUB_BANDS_5];
835 s8 rx_rssi_and_proc_compens_5[CONF_RSSI_AND_PROCESS_COMPENSATION_SIZE];
838 * Dynamic radio parameters for 2.4GHz
842 u16 tx_ref_pd_voltage;
846 s8 tx_rate_limits_normal[CONF_NUMBER_OF_RATE_GROUPS];
847 s8 tx_rate_limits_degraded[CONF_NUMBER_OF_RATE_GROUPS];
848 s8 tx_rate_limits_extreme[CONF_NUMBER_OF_RATE_GROUPS];
850 s8 tx_channel_limits_11b[CONF_NUMBER_OF_CHANNELS_2_4];
851 s8 tx_channel_limits_ofdm[CONF_NUMBER_OF_CHANNELS_2_4];
852 s8 tx_pdv_rate_offsets[CONF_NUMBER_OF_RATE_GROUPS];
854 u8 tx_ibias[CONF_NUMBER_OF_RATE_GROUPS];
855 u8 rx_fem_insertion_loss;
857 u8 degraded_low_to_normal_threshold;
858 u8 degraded_normal_to_high_threshold;
862 * Dynamic radio parameters for 5GHz
866 u16 tx_ref_pd_voltage_5[CONF_NUMBER_OF_SUB_BANDS_5];
867 u8 tx_ref_power_5[CONF_NUMBER_OF_SUB_BANDS_5];
868 s8 tx_offset_db_5[CONF_NUMBER_OF_SUB_BANDS_5];
870 s8 tx_rate_limits_normal_5[CONF_NUMBER_OF_RATE_GROUPS];
871 s8 tx_rate_limits_degraded_5[CONF_NUMBER_OF_RATE_GROUPS];
872 s8 tx_rate_limits_extreme_5[CONF_NUMBER_OF_RATE_GROUPS];
874 s8 tx_channel_limits_ofdm_5[CONF_NUMBER_OF_CHANNELS_5];
875 s8 tx_pdv_rate_offsets_5[CONF_NUMBER_OF_RATE_GROUPS];
877 /* FIXME: this is inconsistent with the types for 2.4GHz */
878 s8 tx_ibias_5[CONF_NUMBER_OF_RATE_GROUPS];
879 s8 rx_fem_insertion_loss_5[CONF_NUMBER_OF_SUB_BANDS_5];
881 u8 degraded_low_to_normal_threshold_5;
882 u8 degraded_normal_to_high_threshold_5;
885 struct conf_init_settings {
887 * Configure general parameters.
889 struct conf_general_parms genparam;
892 * Configure radio parameters.
894 struct conf_radio_parms radioparam;
898 struct conf_itrim_settings {
899 /* enable dco itrim */
902 /* moderation timeout in microsecs from the last TX */
906 struct conf_drv_settings {
907 struct conf_sg_settings sg;
908 struct conf_rx_settings rx;
909 struct conf_tx_settings tx;
910 struct conf_conn_settings conn;
911 struct conf_init_settings init;
912 struct conf_itrim_settings itrim;