linux/drivers/net/wireless/ti/wlcore/conf.h
<<
>>
Prefs
   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
  13enum {
  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
  45enum {
  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
  93enum {
  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
 102struct conf_sg_settings {
 103        u32 params[WLCORE_CONF_SG_PARAMS_MAX];
 104        u8 state;
 105} __packed;
 106
 107enum 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
 112struct 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
 247struct 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
 298enum 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
 307struct 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
 351enum {
 352        CONF_CHANNEL_TYPE_DCF = 0,   /* DC/LEGACY*/
 353        CONF_CHANNEL_TYPE_EDCF = 1,  /* EDCA*/
 354        CONF_CHANNEL_TYPE_HCCA = 2,  /* HCCA*/
 355};
 356
 357enum {
 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
 364enum {
 365        CONF_ACK_POLICY_LEGACY = 0,
 366        CONF_ACK_POLICY_NO_ACK = 1,
 367        CONF_ACK_POLICY_BLOCK = 2,
 368};
 369
 370
 371struct 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
 380struct 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
 478enum {
 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
 494struct 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
 527enum {
 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
 534enum {
 535        CONF_TRIG_EVENT_TYPE_LEVEL = 0,
 536        CONF_TRIG_EVENT_TYPE_EDGE
 537};
 538
 539enum {
 540        CONF_TRIG_EVENT_DIR_LOW = 0,
 541        CONF_TRIG_EVENT_DIR_HIGH,
 542        CONF_TRIG_EVENT_DIR_BIDIR
 543};
 544
 545struct 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
 576enum conf_bcn_filt_mode {
 577        CONF_BCN_FILT_MODE_DISABLED = 0,
 578        CONF_BCN_FILT_MODE_ENABLED = 1
 579};
 580
 581enum conf_bet_mode {
 582        CONF_BET_MODE_DISABLE = 0,
 583        CONF_BET_MODE_ENABLE = 1,
 584};
 585
 586struct 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
 762enum {
 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
 771enum 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
 782struct 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
 790enum conf_fast_wakeup {
 791        CONF_FAST_WAKEUP_ENABLE,
 792        CONF_FAST_WAKEUP_DISABLE,
 793};
 794
 795struct 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
 811struct 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
 848struct 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
 908struct 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
 955struct 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
 964struct 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
1004struct 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
1017struct 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
1049struct 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
1074struct 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
1092struct 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
1106struct 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
1124struct wlcore_conf_header {
1125        __le32 magic;
1126        __le32 version;
1127        __le32 checksum;
1128} __packed;
1129
1130struct 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
1150struct wlcore_conf_file {
1151        struct wlcore_conf_header header;
1152        struct wlcore_conf core;
1153        u8 priv[];
1154} __packed;
1155
1156#endif
1157