linux/drivers/net/wireless/ath/ath10k/wmi.h
<<
>>
Prefs
   1/*
   2 * Copyright (c) 2005-2011 Atheros Communications Inc.
   3 * Copyright (c) 2011-2013 Qualcomm Atheros, Inc.
   4 *
   5 * Permission to use, copy, modify, and/or distribute this software for any
   6 * purpose with or without fee is hereby granted, provided that the above
   7 * copyright notice and this permission notice appear in all copies.
   8 *
   9 * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
  10 * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
  11 * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
  12 * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
  13 * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
  14 * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
  15 * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  16 */
  17
  18#ifndef _WMI_H_
  19#define _WMI_H_
  20
  21#include <linux/types.h>
  22#include <net/mac80211.h>
  23
  24/*
  25 * This file specifies the WMI interface for the Unified Software
  26 * Architecture.
  27 *
  28 * It includes definitions of all the commands and events. Commands are
  29 * messages from the host to the target. Events and Replies are messages
  30 * from the target to the host.
  31 *
  32 * Ownership of correctness in regards to WMI commands belongs to the host
  33 * driver and the target is not required to validate parameters for value,
  34 * proper range, or any other checking.
  35 *
  36 * Guidelines for extending this interface are below.
  37 *
  38 * 1. Add new WMI commands ONLY within the specified range - 0x9000 - 0x9fff
  39 *
  40 * 2. Use ONLY u32 type for defining member variables within WMI
  41 *    command/event structures. Do not use u8, u16, bool or
  42 *    enum types within these structures.
  43 *
  44 * 3. DO NOT define bit fields within structures. Implement bit fields
  45 *    using masks if necessary. Do not use the programming language's bit
  46 *    field definition.
  47 *
  48 * 4. Define macros for encode/decode of u8, u16 fields within
  49 *    the u32 variables. Use these macros for set/get of these fields.
  50 *    Try to use this to optimize the structure without bloating it with
  51 *    u32 variables for every lower sized field.
  52 *
  53 * 5. Do not use PACK/UNPACK attributes for the structures as each member
  54 *    variable is already 4-byte aligned by virtue of being a u32
  55 *    type.
  56 *
  57 * 6. Comment each parameter part of the WMI command/event structure by
  58 *    using the 2 stars at the begining of C comment instead of one star to
  59 *    enable HTML document generation using Doxygen.
  60 *
  61 */
  62
  63/* Control Path */
  64struct wmi_cmd_hdr {
  65        __le32 cmd_id;
  66} __packed;
  67
  68#define WMI_CMD_HDR_CMD_ID_MASK   0x00FFFFFF
  69#define WMI_CMD_HDR_CMD_ID_LSB    0
  70#define WMI_CMD_HDR_PLT_PRIV_MASK 0xFF000000
  71#define WMI_CMD_HDR_PLT_PRIV_LSB  24
  72
  73#define HTC_PROTOCOL_VERSION    0x0002
  74#define WMI_PROTOCOL_VERSION    0x0002
  75
  76enum wmi_service_id {
  77        WMI_SERVICE_BEACON_OFFLOAD = 0,   /* beacon offload */
  78        WMI_SERVICE_SCAN_OFFLOAD,         /* scan offload */
  79        WMI_SERVICE_ROAM_OFFLOAD,         /* roam offload */
  80        WMI_SERVICE_BCN_MISS_OFFLOAD,     /* beacon miss offload */
  81        WMI_SERVICE_STA_PWRSAVE,          /* fake sleep + basic power save */
  82        WMI_SERVICE_STA_ADVANCED_PWRSAVE, /* uapsd, pspoll, force sleep */
  83        WMI_SERVICE_AP_UAPSD,             /* uapsd on AP */
  84        WMI_SERVICE_AP_DFS,               /* DFS on AP */
  85        WMI_SERVICE_11AC,                 /* supports 11ac */
  86        WMI_SERVICE_BLOCKACK,   /* Supports triggering ADDBA/DELBA from host*/
  87        WMI_SERVICE_PHYERR,               /* PHY error */
  88        WMI_SERVICE_BCN_FILTER,           /* Beacon filter support */
  89        WMI_SERVICE_RTT,                  /* RTT (round trip time) support */
  90        WMI_SERVICE_RATECTRL,             /* Rate-control */
  91        WMI_SERVICE_WOW,                  /* WOW Support */
  92        WMI_SERVICE_RATECTRL_CACHE,       /* Rate-control caching */
  93        WMI_SERVICE_IRAM_TIDS,            /* TIDs in IRAM */
  94        WMI_SERVICE_ARPNS_OFFLOAD,        /* ARP NS Offload support */
  95        WMI_SERVICE_NLO,                  /* Network list offload service */
  96        WMI_SERVICE_GTK_OFFLOAD,          /* GTK offload */
  97        WMI_SERVICE_SCAN_SCH,             /* Scan Scheduler Service */
  98        WMI_SERVICE_CSA_OFFLOAD,          /* CSA offload service */
  99        WMI_SERVICE_CHATTER,              /* Chatter service */
 100        WMI_SERVICE_COEX_FREQAVOID,       /* FW report freq range to avoid */
 101        WMI_SERVICE_PACKET_POWER_SAVE,    /* packet power save service */
 102        WMI_SERVICE_FORCE_FW_HANG,        /* To test fw recovery mechanism */
 103        WMI_SERVICE_GPIO,                 /* GPIO service */
 104        WMI_SERVICE_STA_DTIM_PS_MODULATED_DTIM, /* Modulated DTIM support */
 105        WMI_STA_UAPSD_BASIC_AUTO_TRIG,    /* UAPSD AC Trigger Generation  */
 106        WMI_STA_UAPSD_VAR_AUTO_TRIG,      /* -do- */
 107        WMI_SERVICE_STA_KEEP_ALIVE,       /* STA keep alive mechanism support */
 108        WMI_SERVICE_TX_ENCAP,             /* Packet type for TX encapsulation */
 109
 110        WMI_SERVICE_LAST,
 111        WMI_MAX_SERVICE = 64              /* max service */
 112};
 113
 114static inline char *wmi_service_name(int service_id)
 115{
 116        switch (service_id) {
 117        case WMI_SERVICE_BEACON_OFFLOAD:
 118                return "BEACON_OFFLOAD";
 119        case WMI_SERVICE_SCAN_OFFLOAD:
 120                return "SCAN_OFFLOAD";
 121        case WMI_SERVICE_ROAM_OFFLOAD:
 122                return "ROAM_OFFLOAD";
 123        case WMI_SERVICE_BCN_MISS_OFFLOAD:
 124                return "BCN_MISS_OFFLOAD";
 125        case WMI_SERVICE_STA_PWRSAVE:
 126                return "STA_PWRSAVE";
 127        case WMI_SERVICE_STA_ADVANCED_PWRSAVE:
 128                return "STA_ADVANCED_PWRSAVE";
 129        case WMI_SERVICE_AP_UAPSD:
 130                return "AP_UAPSD";
 131        case WMI_SERVICE_AP_DFS:
 132                return "AP_DFS";
 133        case WMI_SERVICE_11AC:
 134                return "11AC";
 135        case WMI_SERVICE_BLOCKACK:
 136                return "BLOCKACK";
 137        case WMI_SERVICE_PHYERR:
 138                return "PHYERR";
 139        case WMI_SERVICE_BCN_FILTER:
 140                return "BCN_FILTER";
 141        case WMI_SERVICE_RTT:
 142                return "RTT";
 143        case WMI_SERVICE_RATECTRL:
 144                return "RATECTRL";
 145        case WMI_SERVICE_WOW:
 146                return "WOW";
 147        case WMI_SERVICE_RATECTRL_CACHE:
 148                return "RATECTRL CACHE";
 149        case WMI_SERVICE_IRAM_TIDS:
 150                return "IRAM TIDS";
 151        case WMI_SERVICE_ARPNS_OFFLOAD:
 152                return "ARPNS_OFFLOAD";
 153        case WMI_SERVICE_NLO:
 154                return "NLO";
 155        case WMI_SERVICE_GTK_OFFLOAD:
 156                return "GTK_OFFLOAD";
 157        case WMI_SERVICE_SCAN_SCH:
 158                return "SCAN_SCH";
 159        case WMI_SERVICE_CSA_OFFLOAD:
 160                return "CSA_OFFLOAD";
 161        case WMI_SERVICE_CHATTER:
 162                return "CHATTER";
 163        case WMI_SERVICE_COEX_FREQAVOID:
 164                return "COEX_FREQAVOID";
 165        case WMI_SERVICE_PACKET_POWER_SAVE:
 166                return "PACKET_POWER_SAVE";
 167        case WMI_SERVICE_FORCE_FW_HANG:
 168                return "FORCE FW HANG";
 169        case WMI_SERVICE_GPIO:
 170                return "GPIO";
 171        case WMI_SERVICE_STA_DTIM_PS_MODULATED_DTIM:
 172                return "MODULATED DTIM";
 173        case WMI_STA_UAPSD_BASIC_AUTO_TRIG:
 174                return "BASIC UAPSD";
 175        case WMI_STA_UAPSD_VAR_AUTO_TRIG:
 176                return "VAR UAPSD";
 177        case WMI_SERVICE_STA_KEEP_ALIVE:
 178                return "STA KEEP ALIVE";
 179        case WMI_SERVICE_TX_ENCAP:
 180                return "TX ENCAP";
 181        default:
 182                return "UNKNOWN SERVICE\n";
 183        }
 184}
 185
 186
 187#define WMI_SERVICE_BM_SIZE \
 188        ((WMI_MAX_SERVICE + sizeof(u32) - 1)/sizeof(u32))
 189
 190/* 2 word representation of MAC addr */
 191struct wmi_mac_addr {
 192        union {
 193                u8 addr[6];
 194                struct {
 195                        u32 word0;
 196                        u32 word1;
 197                } __packed;
 198        } __packed;
 199} __packed;
 200
 201/* macro to convert MAC address from WMI word format to char array */
 202#define WMI_MAC_ADDR_TO_CHAR_ARRAY(pwmi_mac_addr, c_macaddr) do { \
 203        (c_macaddr)[0] =  ((pwmi_mac_addr)->word0) & 0xff; \
 204        (c_macaddr)[1] = (((pwmi_mac_addr)->word0) >> 8) & 0xff; \
 205        (c_macaddr)[2] = (((pwmi_mac_addr)->word0) >> 16) & 0xff; \
 206        (c_macaddr)[3] = (((pwmi_mac_addr)->word0) >> 24) & 0xff; \
 207        (c_macaddr)[4] =  ((pwmi_mac_addr)->word1) & 0xff; \
 208        (c_macaddr)[5] = (((pwmi_mac_addr)->word1) >> 8) & 0xff; \
 209        } while (0)
 210
 211/*
 212 * wmi command groups.
 213 */
 214enum wmi_cmd_group {
 215        /* 0 to 2 are reserved */
 216        WMI_GRP_START = 0x3,
 217        WMI_GRP_SCAN = WMI_GRP_START,
 218        WMI_GRP_PDEV,
 219        WMI_GRP_VDEV,
 220        WMI_GRP_PEER,
 221        WMI_GRP_MGMT,
 222        WMI_GRP_BA_NEG,
 223        WMI_GRP_STA_PS,
 224        WMI_GRP_DFS,
 225        WMI_GRP_ROAM,
 226        WMI_GRP_OFL_SCAN,
 227        WMI_GRP_P2P,
 228        WMI_GRP_AP_PS,
 229        WMI_GRP_RATE_CTRL,
 230        WMI_GRP_PROFILE,
 231        WMI_GRP_SUSPEND,
 232        WMI_GRP_BCN_FILTER,
 233        WMI_GRP_WOW,
 234        WMI_GRP_RTT,
 235        WMI_GRP_SPECTRAL,
 236        WMI_GRP_STATS,
 237        WMI_GRP_ARP_NS_OFL,
 238        WMI_GRP_NLO_OFL,
 239        WMI_GRP_GTK_OFL,
 240        WMI_GRP_CSA_OFL,
 241        WMI_GRP_CHATTER,
 242        WMI_GRP_TID_ADDBA,
 243        WMI_GRP_MISC,
 244        WMI_GRP_GPIO,
 245};
 246
 247#define WMI_CMD_GRP(grp_id) (((grp_id) << 12) | 0x1)
 248#define WMI_EVT_GRP_START_ID(grp_id) (((grp_id) << 12) | 0x1)
 249
 250/* Command IDs and commande events. */
 251enum wmi_cmd_id {
 252        WMI_INIT_CMDID = 0x1,
 253
 254        /* Scan specific commands */
 255        WMI_START_SCAN_CMDID = WMI_CMD_GRP(WMI_GRP_SCAN),
 256        WMI_STOP_SCAN_CMDID,
 257        WMI_SCAN_CHAN_LIST_CMDID,
 258        WMI_SCAN_SCH_PRIO_TBL_CMDID,
 259
 260        /* PDEV (physical device) specific commands */
 261        WMI_PDEV_SET_REGDOMAIN_CMDID = WMI_CMD_GRP(WMI_GRP_PDEV),
 262        WMI_PDEV_SET_CHANNEL_CMDID,
 263        WMI_PDEV_SET_PARAM_CMDID,
 264        WMI_PDEV_PKTLOG_ENABLE_CMDID,
 265        WMI_PDEV_PKTLOG_DISABLE_CMDID,
 266        WMI_PDEV_SET_WMM_PARAMS_CMDID,
 267        WMI_PDEV_SET_HT_CAP_IE_CMDID,
 268        WMI_PDEV_SET_VHT_CAP_IE_CMDID,
 269        WMI_PDEV_SET_DSCP_TID_MAP_CMDID,
 270        WMI_PDEV_SET_QUIET_MODE_CMDID,
 271        WMI_PDEV_GREEN_AP_PS_ENABLE_CMDID,
 272        WMI_PDEV_GET_TPC_CONFIG_CMDID,
 273        WMI_PDEV_SET_BASE_MACADDR_CMDID,
 274
 275        /* VDEV (virtual device) specific commands */
 276        WMI_VDEV_CREATE_CMDID = WMI_CMD_GRP(WMI_GRP_VDEV),
 277        WMI_VDEV_DELETE_CMDID,
 278        WMI_VDEV_START_REQUEST_CMDID,
 279        WMI_VDEV_RESTART_REQUEST_CMDID,
 280        WMI_VDEV_UP_CMDID,
 281        WMI_VDEV_STOP_CMDID,
 282        WMI_VDEV_DOWN_CMDID,
 283        WMI_VDEV_SET_PARAM_CMDID,
 284        WMI_VDEV_INSTALL_KEY_CMDID,
 285
 286        /* peer specific commands */
 287        WMI_PEER_CREATE_CMDID = WMI_CMD_GRP(WMI_GRP_PEER),
 288        WMI_PEER_DELETE_CMDID,
 289        WMI_PEER_FLUSH_TIDS_CMDID,
 290        WMI_PEER_SET_PARAM_CMDID,
 291        WMI_PEER_ASSOC_CMDID,
 292        WMI_PEER_ADD_WDS_ENTRY_CMDID,
 293        WMI_PEER_REMOVE_WDS_ENTRY_CMDID,
 294        WMI_PEER_MCAST_GROUP_CMDID,
 295
 296        /* beacon/management specific commands */
 297        WMI_BCN_TX_CMDID = WMI_CMD_GRP(WMI_GRP_MGMT),
 298        WMI_PDEV_SEND_BCN_CMDID,
 299        WMI_BCN_TMPL_CMDID,
 300        WMI_BCN_FILTER_RX_CMDID,
 301        WMI_PRB_REQ_FILTER_RX_CMDID,
 302        WMI_MGMT_TX_CMDID,
 303        WMI_PRB_TMPL_CMDID,
 304
 305        /* commands to directly control BA negotiation directly from host. */
 306        WMI_ADDBA_CLEAR_RESP_CMDID = WMI_CMD_GRP(WMI_GRP_BA_NEG),
 307        WMI_ADDBA_SEND_CMDID,
 308        WMI_ADDBA_STATUS_CMDID,
 309        WMI_DELBA_SEND_CMDID,
 310        WMI_ADDBA_SET_RESP_CMDID,
 311        WMI_SEND_SINGLEAMSDU_CMDID,
 312
 313        /* Station power save specific config */
 314        WMI_STA_POWERSAVE_MODE_CMDID = WMI_CMD_GRP(WMI_GRP_STA_PS),
 315        WMI_STA_POWERSAVE_PARAM_CMDID,
 316        WMI_STA_MIMO_PS_MODE_CMDID,
 317
 318        /** DFS-specific commands */
 319        WMI_PDEV_DFS_ENABLE_CMDID = WMI_CMD_GRP(WMI_GRP_DFS),
 320        WMI_PDEV_DFS_DISABLE_CMDID,
 321
 322        /* Roaming specific  commands */
 323        WMI_ROAM_SCAN_MODE = WMI_CMD_GRP(WMI_GRP_ROAM),
 324        WMI_ROAM_SCAN_RSSI_THRESHOLD,
 325        WMI_ROAM_SCAN_PERIOD,
 326        WMI_ROAM_SCAN_RSSI_CHANGE_THRESHOLD,
 327        WMI_ROAM_AP_PROFILE,
 328
 329        /* offload scan specific commands */
 330        WMI_OFL_SCAN_ADD_AP_PROFILE = WMI_CMD_GRP(WMI_GRP_OFL_SCAN),
 331        WMI_OFL_SCAN_REMOVE_AP_PROFILE,
 332        WMI_OFL_SCAN_PERIOD,
 333
 334        /* P2P specific commands */
 335        WMI_P2P_DEV_SET_DEVICE_INFO = WMI_CMD_GRP(WMI_GRP_P2P),
 336        WMI_P2P_DEV_SET_DISCOVERABILITY,
 337        WMI_P2P_GO_SET_BEACON_IE,
 338        WMI_P2P_GO_SET_PROBE_RESP_IE,
 339        WMI_P2P_SET_VENDOR_IE_DATA_CMDID,
 340
 341        /* AP power save specific config */
 342        WMI_AP_PS_PEER_PARAM_CMDID = WMI_CMD_GRP(WMI_GRP_AP_PS),
 343        WMI_AP_PS_PEER_UAPSD_COEX_CMDID,
 344
 345        /* Rate-control specific commands */
 346        WMI_PEER_RATE_RETRY_SCHED_CMDID =
 347        WMI_CMD_GRP(WMI_GRP_RATE_CTRL),
 348
 349        /* WLAN Profiling commands. */
 350        WMI_WLAN_PROFILE_TRIGGER_CMDID = WMI_CMD_GRP(WMI_GRP_PROFILE),
 351        WMI_WLAN_PROFILE_SET_HIST_INTVL_CMDID,
 352        WMI_WLAN_PROFILE_GET_PROFILE_DATA_CMDID,
 353        WMI_WLAN_PROFILE_ENABLE_PROFILE_ID_CMDID,
 354        WMI_WLAN_PROFILE_LIST_PROFILE_ID_CMDID,
 355
 356        /* Suspend resume command Ids */
 357        WMI_PDEV_SUSPEND_CMDID = WMI_CMD_GRP(WMI_GRP_SUSPEND),
 358        WMI_PDEV_RESUME_CMDID,
 359
 360        /* Beacon filter commands */
 361        WMI_ADD_BCN_FILTER_CMDID = WMI_CMD_GRP(WMI_GRP_BCN_FILTER),
 362        WMI_RMV_BCN_FILTER_CMDID,
 363
 364        /* WOW Specific WMI commands*/
 365        WMI_WOW_ADD_WAKE_PATTERN_CMDID = WMI_CMD_GRP(WMI_GRP_WOW),
 366        WMI_WOW_DEL_WAKE_PATTERN_CMDID,
 367        WMI_WOW_ENABLE_DISABLE_WAKE_EVENT_CMDID,
 368        WMI_WOW_ENABLE_CMDID,
 369        WMI_WOW_HOSTWAKEUP_FROM_SLEEP_CMDID,
 370
 371        /* RTT measurement related cmd */
 372        WMI_RTT_MEASREQ_CMDID = WMI_CMD_GRP(WMI_GRP_RTT),
 373        WMI_RTT_TSF_CMDID,
 374
 375        /* spectral scan commands */
 376        WMI_VDEV_SPECTRAL_SCAN_CONFIGURE_CMDID = WMI_CMD_GRP(WMI_GRP_SPECTRAL),
 377        WMI_VDEV_SPECTRAL_SCAN_ENABLE_CMDID,
 378
 379        /* F/W stats */
 380        WMI_REQUEST_STATS_CMDID = WMI_CMD_GRP(WMI_GRP_STATS),
 381
 382        /* ARP OFFLOAD REQUEST*/
 383        WMI_SET_ARP_NS_OFFLOAD_CMDID = WMI_CMD_GRP(WMI_GRP_ARP_NS_OFL),
 384
 385        /* NS offload confid*/
 386        WMI_NETWORK_LIST_OFFLOAD_CONFIG_CMDID = WMI_CMD_GRP(WMI_GRP_NLO_OFL),
 387
 388        /* GTK offload Specific WMI commands*/
 389        WMI_GTK_OFFLOAD_CMDID = WMI_CMD_GRP(WMI_GRP_GTK_OFL),
 390
 391        /* CSA offload Specific WMI commands*/
 392        WMI_CSA_OFFLOAD_ENABLE_CMDID = WMI_CMD_GRP(WMI_GRP_CSA_OFL),
 393        WMI_CSA_OFFLOAD_CHANSWITCH_CMDID,
 394
 395        /* Chatter commands*/
 396        WMI_CHATTER_SET_MODE_CMDID = WMI_CMD_GRP(WMI_GRP_CHATTER),
 397
 398        /* addba specific commands */
 399        WMI_PEER_TID_ADDBA_CMDID = WMI_CMD_GRP(WMI_GRP_TID_ADDBA),
 400        WMI_PEER_TID_DELBA_CMDID,
 401
 402        /* set station mimo powersave method */
 403        WMI_STA_DTIM_PS_METHOD_CMDID,
 404        /* Configure the Station UAPSD AC Auto Trigger Parameters */
 405        WMI_STA_UAPSD_AUTO_TRIG_CMDID,
 406
 407        /* STA Keep alive parameter configuration,
 408           Requires WMI_SERVICE_STA_KEEP_ALIVE */
 409        WMI_STA_KEEPALIVE_CMD,
 410
 411        /* misc command group */
 412        WMI_ECHO_CMDID = WMI_CMD_GRP(WMI_GRP_MISC),
 413        WMI_PDEV_UTF_CMDID,
 414        WMI_DBGLOG_CFG_CMDID,
 415        WMI_PDEV_QVIT_CMDID,
 416        WMI_PDEV_FTM_INTG_CMDID,
 417        WMI_VDEV_SET_KEEPALIVE_CMDID,
 418        WMI_VDEV_GET_KEEPALIVE_CMDID,
 419        WMI_FORCE_FW_HANG_CMDID,
 420
 421        /* GPIO Configuration */
 422        WMI_GPIO_CONFIG_CMDID = WMI_CMD_GRP(WMI_GRP_GPIO),
 423        WMI_GPIO_OUTPUT_CMDID,
 424};
 425
 426enum wmi_event_id {
 427        WMI_SERVICE_READY_EVENTID = 0x1,
 428        WMI_READY_EVENTID,
 429
 430        /* Scan specific events */
 431        WMI_SCAN_EVENTID = WMI_EVT_GRP_START_ID(WMI_GRP_SCAN),
 432
 433        /* PDEV specific events */
 434        WMI_PDEV_TPC_CONFIG_EVENTID = WMI_EVT_GRP_START_ID(WMI_GRP_PDEV),
 435        WMI_CHAN_INFO_EVENTID,
 436        WMI_PHYERR_EVENTID,
 437
 438        /* VDEV specific events */
 439        WMI_VDEV_START_RESP_EVENTID = WMI_EVT_GRP_START_ID(WMI_GRP_VDEV),
 440        WMI_VDEV_STOPPED_EVENTID,
 441        WMI_VDEV_INSTALL_KEY_COMPLETE_EVENTID,
 442
 443        /* peer specific events */
 444        WMI_PEER_STA_KICKOUT_EVENTID = WMI_EVT_GRP_START_ID(WMI_GRP_PEER),
 445
 446        /* beacon/mgmt specific events */
 447        WMI_MGMT_RX_EVENTID = WMI_EVT_GRP_START_ID(WMI_GRP_MGMT),
 448        WMI_HOST_SWBA_EVENTID,
 449        WMI_TBTTOFFSET_UPDATE_EVENTID,
 450
 451        /* ADDBA Related WMI Events*/
 452        WMI_TX_DELBA_COMPLETE_EVENTID = WMI_EVT_GRP_START_ID(WMI_GRP_BA_NEG),
 453        WMI_TX_ADDBA_COMPLETE_EVENTID,
 454
 455        /* Roam event to trigger roaming on host */
 456        WMI_ROAM_EVENTID = WMI_EVT_GRP_START_ID(WMI_GRP_ROAM),
 457        WMI_PROFILE_MATCH,
 458
 459        /* WoW */
 460        WMI_WOW_WAKEUP_HOST_EVENTID = WMI_EVT_GRP_START_ID(WMI_GRP_WOW),
 461
 462        /* RTT */
 463        WMI_RTT_MEASUREMENT_REPORT_EVENTID = WMI_EVT_GRP_START_ID(WMI_GRP_RTT),
 464        WMI_TSF_MEASUREMENT_REPORT_EVENTID,
 465        WMI_RTT_ERROR_REPORT_EVENTID,
 466
 467        /* GTK offload */
 468        WMI_GTK_OFFLOAD_STATUS_EVENTID = WMI_EVT_GRP_START_ID(WMI_GRP_GTK_OFL),
 469        WMI_GTK_REKEY_FAIL_EVENTID,
 470
 471        /* CSA IE received event */
 472        WMI_CSA_HANDLING_EVENTID = WMI_EVT_GRP_START_ID(WMI_GRP_CSA_OFL),
 473
 474        /* Misc events */
 475        WMI_ECHO_EVENTID = WMI_EVT_GRP_START_ID(WMI_GRP_MISC),
 476        WMI_PDEV_UTF_EVENTID,
 477        WMI_DEBUG_MESG_EVENTID,
 478        WMI_UPDATE_STATS_EVENTID,
 479        WMI_DEBUG_PRINT_EVENTID,
 480        WMI_DCS_INTERFERENCE_EVENTID,
 481        WMI_PDEV_QVIT_EVENTID,
 482        WMI_WLAN_PROFILE_DATA_EVENTID,
 483        WMI_PDEV_FTM_INTG_EVENTID,
 484        WMI_WLAN_FREQ_AVOID_EVENTID,
 485        WMI_VDEV_GET_KEEPALIVE_EVENTID,
 486
 487        /* GPIO Event */
 488        WMI_GPIO_INPUT_EVENTID = WMI_EVT_GRP_START_ID(WMI_GRP_GPIO),
 489};
 490
 491enum wmi_phy_mode {
 492        MODE_11A        = 0,   /* 11a Mode */
 493        MODE_11G        = 1,   /* 11b/g Mode */
 494        MODE_11B        = 2,   /* 11b Mode */
 495        MODE_11GONLY    = 3,   /* 11g only Mode */
 496        MODE_11NA_HT20   = 4,  /* 11a HT20 mode */
 497        MODE_11NG_HT20   = 5,  /* 11g HT20 mode */
 498        MODE_11NA_HT40   = 6,  /* 11a HT40 mode */
 499        MODE_11NG_HT40   = 7,  /* 11g HT40 mode */
 500        MODE_11AC_VHT20 = 8,
 501        MODE_11AC_VHT40 = 9,
 502        MODE_11AC_VHT80 = 10,
 503        /*    MODE_11AC_VHT160 = 11, */
 504        MODE_11AC_VHT20_2G = 11,
 505        MODE_11AC_VHT40_2G = 12,
 506        MODE_11AC_VHT80_2G = 13,
 507        MODE_UNKNOWN    = 14,
 508        MODE_MAX        = 14
 509};
 510
 511#define WMI_CHAN_LIST_TAG       0x1
 512#define WMI_SSID_LIST_TAG       0x2
 513#define WMI_BSSID_LIST_TAG      0x3
 514#define WMI_IE_TAG              0x4
 515
 516struct wmi_channel {
 517        __le32 mhz;
 518        __le32 band_center_freq1;
 519        __le32 band_center_freq2; /* valid for 11ac, 80plus80 */
 520        union {
 521                __le32 flags; /* WMI_CHAN_FLAG_ */
 522                struct {
 523                        u8 mode; /* only 6 LSBs */
 524                } __packed;
 525        } __packed;
 526        union {
 527                __le32 reginfo0;
 528                struct {
 529                        u8 min_power;
 530                        u8 max_power;
 531                        u8 reg_power;
 532                        u8 reg_classid;
 533                } __packed;
 534        } __packed;
 535        union {
 536                __le32 reginfo1;
 537                struct {
 538                        u8 antenna_max;
 539                } __packed;
 540        } __packed;
 541} __packed;
 542
 543struct wmi_channel_arg {
 544        u32 freq;
 545        u32 band_center_freq1;
 546        bool passive;
 547        bool allow_ibss;
 548        bool allow_ht;
 549        bool allow_vht;
 550        bool ht40plus;
 551        /* note: power unit is 1/4th of dBm */
 552        u32 min_power;
 553        u32 max_power;
 554        u32 max_reg_power;
 555        u32 max_antenna_gain;
 556        u32 reg_class_id;
 557        enum wmi_phy_mode mode;
 558};
 559
 560enum wmi_channel_change_cause {
 561        WMI_CHANNEL_CHANGE_CAUSE_NONE = 0,
 562        WMI_CHANNEL_CHANGE_CAUSE_CSA,
 563};
 564
 565#define WMI_CHAN_FLAG_HT40_PLUS      (1 << 6)
 566#define WMI_CHAN_FLAG_PASSIVE        (1 << 7)
 567#define WMI_CHAN_FLAG_ADHOC_ALLOWED  (1 << 8)
 568#define WMI_CHAN_FLAG_AP_DISABLED    (1 << 9)
 569#define WMI_CHAN_FLAG_DFS            (1 << 10)
 570#define WMI_CHAN_FLAG_ALLOW_HT       (1 << 11)
 571#define WMI_CHAN_FLAG_ALLOW_VHT      (1 << 12)
 572
 573/* Indicate reason for channel switch */
 574#define WMI_CHANNEL_CHANGE_CAUSE_CSA (1 << 13)
 575
 576#define WMI_MAX_SPATIAL_STREAM   3
 577
 578/* HT Capabilities*/
 579#define WMI_HT_CAP_ENABLED                0x0001   /* HT Enabled/ disabled */
 580#define WMI_HT_CAP_HT20_SGI       0x0002   /* Short Guard Interval with HT20 */
 581#define WMI_HT_CAP_DYNAMIC_SMPS           0x0004   /* Dynamic MIMO powersave */
 582#define WMI_HT_CAP_TX_STBC                0x0008   /* B3 TX STBC */
 583#define WMI_HT_CAP_TX_STBC_MASK_SHIFT     3
 584#define WMI_HT_CAP_RX_STBC                0x0030   /* B4-B5 RX STBC */
 585#define WMI_HT_CAP_RX_STBC_MASK_SHIFT     4
 586#define WMI_HT_CAP_LDPC                   0x0040   /* LDPC supported */
 587#define WMI_HT_CAP_L_SIG_TXOP_PROT        0x0080   /* L-SIG TXOP Protection */
 588#define WMI_HT_CAP_MPDU_DENSITY           0x0700   /* MPDU Density */
 589#define WMI_HT_CAP_MPDU_DENSITY_MASK_SHIFT 8
 590#define WMI_HT_CAP_HT40_SGI               0x0800
 591
 592#define WMI_HT_CAP_DEFAULT_ALL (WMI_HT_CAP_ENABLED       | \
 593                                WMI_HT_CAP_HT20_SGI      | \
 594                                WMI_HT_CAP_HT40_SGI      | \
 595                                WMI_HT_CAP_TX_STBC       | \
 596                                WMI_HT_CAP_RX_STBC       | \
 597                                WMI_HT_CAP_LDPC)
 598
 599
 600/*
 601 * WMI_VHT_CAP_* these maps to ieee 802.11ac vht capability information
 602 * field. The fields not defined here are not supported, or reserved.
 603 * Do not change these masks and if you have to add new one follow the
 604 * bitmask as specified by 802.11ac draft.
 605 */
 606
 607#define WMI_VHT_CAP_MAX_MPDU_LEN_MASK            0x00000003
 608#define WMI_VHT_CAP_RX_LDPC                      0x00000010
 609#define WMI_VHT_CAP_SGI_80MHZ                    0x00000020
 610#define WMI_VHT_CAP_TX_STBC                      0x00000080
 611#define WMI_VHT_CAP_RX_STBC_MASK                 0x00000300
 612#define WMI_VHT_CAP_RX_STBC_MASK_SHIFT           8
 613#define WMI_VHT_CAP_MAX_AMPDU_LEN_EXP            0x03800000
 614#define WMI_VHT_CAP_MAX_AMPDU_LEN_EXP_SHIFT      23
 615#define WMI_VHT_CAP_RX_FIXED_ANT                 0x10000000
 616#define WMI_VHT_CAP_TX_FIXED_ANT                 0x20000000
 617
 618/* The following also refer for max HT AMSDU */
 619#define WMI_VHT_CAP_MAX_MPDU_LEN_3839            0x00000000
 620#define WMI_VHT_CAP_MAX_MPDU_LEN_7935            0x00000001
 621#define WMI_VHT_CAP_MAX_MPDU_LEN_11454           0x00000002
 622
 623#define WMI_VHT_CAP_DEFAULT_ALL (WMI_VHT_CAP_MAX_MPDU_LEN_11454  | \
 624                                 WMI_VHT_CAP_RX_LDPC             | \
 625                                 WMI_VHT_CAP_SGI_80MHZ           | \
 626                                 WMI_VHT_CAP_TX_STBC             | \
 627                                 WMI_VHT_CAP_RX_STBC_MASK        | \
 628                                 WMI_VHT_CAP_MAX_AMPDU_LEN_EXP   | \
 629                                 WMI_VHT_CAP_RX_FIXED_ANT        | \
 630                                 WMI_VHT_CAP_TX_FIXED_ANT)
 631
 632/*
 633 * Interested readers refer to Rx/Tx MCS Map definition as defined in
 634 * 802.11ac
 635 */
 636#define WMI_VHT_MAX_MCS_4_SS_MASK(r, ss)      ((3 & (r)) << (((ss) - 1) << 1))
 637#define WMI_VHT_MAX_SUPP_RATE_MASK           0x1fff0000
 638#define WMI_VHT_MAX_SUPP_RATE_MASK_SHIFT     16
 639
 640enum {
 641        REGDMN_MODE_11A              = 0x00001, /* 11a channels */
 642        REGDMN_MODE_TURBO            = 0x00002, /* 11a turbo-only channels */
 643        REGDMN_MODE_11B              = 0x00004, /* 11b channels */
 644        REGDMN_MODE_PUREG            = 0x00008, /* 11g channels (OFDM only) */
 645        REGDMN_MODE_11G              = 0x00008, /* XXX historical */
 646        REGDMN_MODE_108G             = 0x00020, /* 11a+Turbo channels */
 647        REGDMN_MODE_108A             = 0x00040, /* 11g+Turbo channels */
 648        REGDMN_MODE_XR               = 0x00100, /* XR channels */
 649        REGDMN_MODE_11A_HALF_RATE    = 0x00200, /* 11A half rate channels */
 650        REGDMN_MODE_11A_QUARTER_RATE = 0x00400, /* 11A quarter rate channels */
 651        REGDMN_MODE_11NG_HT20        = 0x00800, /* 11N-G HT20 channels */
 652        REGDMN_MODE_11NA_HT20        = 0x01000, /* 11N-A HT20 channels */
 653        REGDMN_MODE_11NG_HT40PLUS    = 0x02000, /* 11N-G HT40 + channels */
 654        REGDMN_MODE_11NG_HT40MINUS   = 0x04000, /* 11N-G HT40 - channels */
 655        REGDMN_MODE_11NA_HT40PLUS    = 0x08000, /* 11N-A HT40 + channels */
 656        REGDMN_MODE_11NA_HT40MINUS   = 0x10000, /* 11N-A HT40 - channels */
 657        REGDMN_MODE_11AC_VHT20       = 0x20000, /* 5Ghz, VHT20 */
 658        REGDMN_MODE_11AC_VHT40PLUS   = 0x40000, /* 5Ghz, VHT40 + channels */
 659        REGDMN_MODE_11AC_VHT40MINUS  = 0x80000, /* 5Ghz  VHT40 - channels */
 660        REGDMN_MODE_11AC_VHT80       = 0x100000, /* 5Ghz, VHT80 channels */
 661        REGDMN_MODE_ALL              = 0xffffffff
 662};
 663
 664#define REGDMN_CAP1_CHAN_HALF_RATE        0x00000001
 665#define REGDMN_CAP1_CHAN_QUARTER_RATE     0x00000002
 666#define REGDMN_CAP1_CHAN_HAL49GHZ         0x00000004
 667
 668/* regulatory capabilities */
 669#define REGDMN_EEPROM_EEREGCAP_EN_FCC_MIDBAND   0x0040
 670#define REGDMN_EEPROM_EEREGCAP_EN_KK_U1_EVEN    0x0080
 671#define REGDMN_EEPROM_EEREGCAP_EN_KK_U2         0x0100
 672#define REGDMN_EEPROM_EEREGCAP_EN_KK_MIDBAND    0x0200
 673#define REGDMN_EEPROM_EEREGCAP_EN_KK_U1_ODD     0x0400
 674#define REGDMN_EEPROM_EEREGCAP_EN_KK_NEW_11A    0x0800
 675
 676struct hal_reg_capabilities {
 677        /* regdomain value specified in EEPROM */
 678        __le32 eeprom_rd;
 679        /*regdomain */
 680        __le32 eeprom_rd_ext;
 681        /* CAP1 capabilities bit map. */
 682        __le32 regcap1;
 683        /* REGDMN EEPROM CAP. */
 684        __le32 regcap2;
 685        /* REGDMN MODE */
 686        __le32 wireless_modes;
 687        __le32 low_2ghz_chan;
 688        __le32 high_2ghz_chan;
 689        __le32 low_5ghz_chan;
 690        __le32 high_5ghz_chan;
 691} __packed;
 692
 693enum wlan_mode_capability {
 694        WHAL_WLAN_11A_CAPABILITY   = 0x1,
 695        WHAL_WLAN_11G_CAPABILITY   = 0x2,
 696        WHAL_WLAN_11AG_CAPABILITY  = 0x3,
 697};
 698
 699/* structure used by FW for requesting host memory */
 700struct wlan_host_mem_req {
 701        /* ID of the request */
 702        __le32 req_id;
 703        /* size of the  of each unit */
 704        __le32 unit_size;
 705        /* flags to  indicate that
 706         * the number units is dependent
 707         * on number of resources(num vdevs num peers .. etc)
 708         */
 709        __le32 num_unit_info;
 710        /*
 711         * actual number of units to allocate . if flags in the num_unit_info
 712         * indicate that number of units is tied to number of a particular
 713         * resource to allocate then  num_units filed is set to 0 and host
 714         * will derive the number units from number of the resources it is
 715         * requesting.
 716         */
 717        __le32 num_units;
 718} __packed;
 719
 720#define WMI_SERVICE_IS_ENABLED(wmi_svc_bmap, svc_id) \
 721        ((((wmi_svc_bmap)[(svc_id)/(sizeof(u32))]) & \
 722        (1 << ((svc_id)%(sizeof(u32))))) != 0)
 723
 724/*
 725 * The following struct holds optional payload for
 726 * wmi_service_ready_event,e.g., 11ac pass some of the
 727 * device capability to the host.
 728 */
 729struct wmi_service_ready_event {
 730        __le32 sw_version;
 731        __le32 sw_version_1;
 732        __le32 abi_version;
 733        /* WMI_PHY_CAPABILITY */
 734        __le32 phy_capability;
 735        /* Maximum number of frag table entries that SW will populate less 1 */
 736        __le32 max_frag_entry;
 737        __le32 wmi_service_bitmap[WMI_SERVICE_BM_SIZE];
 738        __le32 num_rf_chains;
 739        /*
 740         * The following field is only valid for service type
 741         * WMI_SERVICE_11AC
 742         */
 743        __le32 ht_cap_info; /* WMI HT Capability */
 744        __le32 vht_cap_info; /* VHT capability info field of 802.11ac */
 745        __le32 vht_supp_mcs; /* VHT Supported MCS Set field Rx/Tx same */
 746        __le32 hw_min_tx_power;
 747        __le32 hw_max_tx_power;
 748        struct hal_reg_capabilities hal_reg_capabilities;
 749        __le32 sys_cap_info;
 750        __le32 min_pkt_size_enable; /* Enterprise mode short pkt enable */
 751        /*
 752         * Max beacon and Probe Response IE offload size
 753         * (includes optional P2P IEs)
 754         */
 755        __le32 max_bcn_ie_size;
 756        /*
 757         * request to host to allocate a chuck of memory and pss it down to FW
 758         * via WM_INIT. FW uses this as FW extesnsion memory for saving its
 759         * data structures. Only valid for low latency interfaces like PCIE
 760         * where FW can access this memory directly (or) by DMA.
 761         */
 762        __le32 num_mem_reqs;
 763        struct wlan_host_mem_req mem_reqs[1];
 764} __packed;
 765
 766/*
 767 * status consists of  upper 16 bits fo int status and lower 16 bits of
 768 * module ID that retuned status
 769 */
 770#define WLAN_INIT_STATUS_SUCCESS   0x0
 771#define WLAN_GET_INIT_STATUS_REASON(status)    ((status) & 0xffff)
 772#define WLAN_GET_INIT_STATUS_MODULE_ID(status) (((status) >> 16) & 0xffff)
 773
 774#define WMI_SERVICE_READY_TIMEOUT_HZ (5*HZ)
 775#define WMI_UNIFIED_READY_TIMEOUT_HZ (5*HZ)
 776
 777struct wmi_ready_event {
 778        __le32 sw_version;
 779        __le32 abi_version;
 780        struct wmi_mac_addr mac_addr;
 781        __le32 status;
 782} __packed;
 783
 784struct wmi_resource_config {
 785        /* number of virtual devices (VAPs) to support */
 786        __le32 num_vdevs;
 787
 788        /* number of peer nodes to support */
 789        __le32 num_peers;
 790
 791        /*
 792         * In offload mode target supports features like WOW, chatter and
 793         * other protocol offloads. In order to support them some
 794         * functionalities like reorder buffering, PN checking need to be
 795         * done in target. This determines maximum number of peers suported
 796         * by target in offload mode
 797         */
 798        __le32 num_offload_peers;
 799
 800        /* For target-based RX reordering */
 801        __le32 num_offload_reorder_bufs;
 802
 803        /* number of keys per peer */
 804        __le32 num_peer_keys;
 805
 806        /* total number of TX/RX data TIDs */
 807        __le32 num_tids;
 808
 809        /*
 810         * max skid for resolving hash collisions
 811         *
 812         *   The address search table is sparse, so that if two MAC addresses
 813         *   result in the same hash value, the second of these conflicting
 814         *   entries can slide to the next index in the address search table,
 815         *   and use it, if it is unoccupied.  This ast_skid_limit parameter
 816         *   specifies the upper bound on how many subsequent indices to search
 817         *   over to find an unoccupied space.
 818         */
 819        __le32 ast_skid_limit;
 820
 821        /*
 822         * the nominal chain mask for transmit
 823         *
 824         *   The chain mask may be modified dynamically, e.g. to operate AP
 825         *   tx with a reduced number of chains if no clients are associated.
 826         *   This configuration parameter specifies the nominal chain-mask that
 827         *   should be used when not operating with a reduced set of tx chains.
 828         */
 829        __le32 tx_chain_mask;
 830
 831        /*
 832         * the nominal chain mask for receive
 833         *
 834         *   The chain mask may be modified dynamically, e.g. for a client
 835         *   to use a reduced number of chains for receive if the traffic to
 836         *   the client is low enough that it doesn't require downlink MIMO
 837         *   or antenna diversity.
 838         *   This configuration parameter specifies the nominal chain-mask that
 839         *   should be used when not operating with a reduced set of rx chains.
 840         */
 841        __le32 rx_chain_mask;
 842
 843        /*
 844         * what rx reorder timeout (ms) to use for the AC
 845         *
 846         *   Each WMM access class (voice, video, best-effort, background) will
 847         *   have its own timeout value to dictate how long to wait for missing
 848         *   rx MPDUs to arrive before flushing subsequent MPDUs that have
 849         *   already been received.
 850         *   This parameter specifies the timeout in milliseconds for each
 851         *   class.
 852         */
 853        __le32 rx_timeout_pri_vi;
 854        __le32 rx_timeout_pri_vo;
 855        __le32 rx_timeout_pri_be;
 856        __le32 rx_timeout_pri_bk;
 857
 858        /*
 859         * what mode the rx should decap packets to
 860         *
 861         *   MAC can decap to RAW (no decap), native wifi or Ethernet types
 862         *   THis setting also determines the default TX behavior, however TX
 863         *   behavior can be modified on a per VAP basis during VAP init
 864         */
 865        __le32 rx_decap_mode;
 866
 867        /* what is the maximum scan requests than can be queued */
 868        __le32 scan_max_pending_reqs;
 869
 870        /* maximum VDEV that could use BMISS offload */
 871        __le32 bmiss_offload_max_vdev;
 872
 873        /* maximum VDEV that could use offload roaming */
 874        __le32 roam_offload_max_vdev;
 875
 876        /* maximum AP profiles that would push to offload roaming */
 877        __le32 roam_offload_max_ap_profiles;
 878
 879        /*
 880         * how many groups to use for mcast->ucast conversion
 881         *
 882         *   The target's WAL maintains a table to hold information regarding
 883         *   which peers belong to a given multicast group, so that if
 884         *   multicast->unicast conversion is enabled, the target can convert
 885         *   multicast tx frames to a series of unicast tx frames, to each
 886         *   peer within the multicast group.
 887             This num_mcast_groups configuration parameter tells the target how
 888         *   many multicast groups to provide storage for within its multicast
 889         *   group membership table.
 890         */
 891        __le32 num_mcast_groups;
 892
 893        /*
 894         * size to alloc for the mcast membership table
 895         *
 896         *   This num_mcast_table_elems configuration parameter tells the
 897         *   target how many peer elements it needs to provide storage for in
 898         *   its multicast group membership table.
 899         *   These multicast group membership table elements are shared by the
 900         *   multicast groups stored within the table.
 901         */
 902        __le32 num_mcast_table_elems;
 903
 904        /*
 905         * whether/how to do multicast->unicast conversion
 906         *
 907         *   This configuration parameter specifies whether the target should
 908         *   perform multicast --> unicast conversion on transmit, and if so,
 909         *   what to do if it finds no entries in its multicast group
 910         *   membership table for the multicast IP address in the tx frame.
 911         *   Configuration value:
 912         *   0 -> Do not perform multicast to unicast conversion.
 913         *   1 -> Convert multicast frames to unicast, if the IP multicast
 914         *        address from the tx frame is found in the multicast group
 915         *        membership table.  If the IP multicast address is not found,
 916         *        drop the frame.
 917         *   2 -> Convert multicast frames to unicast, if the IP multicast
 918         *        address from the tx frame is found in the multicast group
 919         *        membership table.  If the IP multicast address is not found,
 920         *        transmit the frame as multicast.
 921         */
 922        __le32 mcast2ucast_mode;
 923
 924        /*
 925         * how much memory to allocate for a tx PPDU dbg log
 926         *
 927         *   This parameter controls how much memory the target will allocate
 928         *   to store a log of tx PPDU meta-information (how large the PPDU
 929         *   was, when it was sent, whether it was successful, etc.)
 930         */
 931        __le32 tx_dbg_log_size;
 932
 933        /* how many AST entries to be allocated for WDS */
 934        __le32 num_wds_entries;
 935
 936        /*
 937         * MAC DMA burst size, e.g., For target PCI limit can be
 938         * 0 -default, 1 256B
 939         */
 940        __le32 dma_burst_size;
 941
 942        /*
 943         * Fixed delimiters to be inserted after every MPDU to
 944         * account for interface latency to avoid underrun.
 945         */
 946        __le32 mac_aggr_delim;
 947
 948        /*
 949         *   determine whether target is responsible for detecting duplicate
 950         *   non-aggregate MPDU and timing out stale fragments.
 951         *
 952         *   A-MPDU reordering is always performed on the target.
 953         *
 954         *   0: target responsible for frag timeout and dup checking
 955         *   1: host responsible for frag timeout and dup checking
 956         */
 957        __le32 rx_skip_defrag_timeout_dup_detection_check;
 958
 959        /*
 960         * Configuration for VoW :
 961         * No of Video Nodes to be supported
 962         * and Max no of descriptors for each Video link (node).
 963         */
 964        __le32 vow_config;
 965
 966        /* maximum VDEV that could use GTK offload */
 967        __le32 gtk_offload_max_vdev;
 968
 969        /* Number of msdu descriptors target should use */
 970        __le32 num_msdu_desc;
 971
 972        /*
 973         * Max. number of Tx fragments per MSDU
 974         *  This parameter controls the max number of Tx fragments per MSDU.
 975         *  This is sent by the target as part of the WMI_SERVICE_READY event
 976         *  and is overriden by the OS shim as required.
 977         */
 978        __le32 max_frag_entries;
 979} __packed;
 980
 981/* strucutre describing host memory chunk. */
 982struct host_memory_chunk {
 983        /* id of the request that is passed up in service ready */
 984        __le32 req_id;
 985        /* the physical address the memory chunk */
 986        __le32 ptr;
 987        /* size of the chunk */
 988        __le32 size;
 989} __packed;
 990
 991struct wmi_init_cmd {
 992        struct wmi_resource_config resource_config;
 993        __le32 num_host_mem_chunks;
 994
 995        /*
 996         * variable number of host memory chunks.
 997         * This should be the last element in the structure
 998         */
 999        struct host_memory_chunk host_mem_chunks[1];
1000} __packed;
1001
1002/* TLV for channel list */
1003struct wmi_chan_list {
1004        __le32 tag; /* WMI_CHAN_LIST_TAG */
1005        __le32 num_chan;
1006        __le32 channel_list[0];
1007} __packed;
1008
1009struct wmi_bssid_list {
1010        __le32 tag; /* WMI_BSSID_LIST_TAG */
1011        __le32 num_bssid;
1012        struct wmi_mac_addr bssid_list[0];
1013} __packed;
1014
1015struct wmi_ie_data {
1016        __le32 tag; /* WMI_IE_TAG */
1017        __le32 ie_len;
1018        u8 ie_data[0];
1019} __packed;
1020
1021struct wmi_ssid {
1022        __le32 ssid_len;
1023        u8 ssid[32];
1024} __packed;
1025
1026struct wmi_ssid_list {
1027        __le32 tag; /* WMI_SSID_LIST_TAG */
1028        __le32 num_ssids;
1029        struct wmi_ssid ssids[0];
1030} __packed;
1031
1032/* prefix used by scan requestor ids on the host */
1033#define WMI_HOST_SCAN_REQUESTOR_ID_PREFIX 0xA000
1034
1035/* prefix used by scan request ids generated on the host */
1036/* host cycles through the lower 12 bits to generate ids */
1037#define WMI_HOST_SCAN_REQ_ID_PREFIX 0xA000
1038
1039#define WLAN_SCAN_PARAMS_MAX_SSID    16
1040#define WLAN_SCAN_PARAMS_MAX_BSSID   4
1041#define WLAN_SCAN_PARAMS_MAX_IE_LEN  256
1042
1043/* Scan priority numbers must be sequential, starting with 0 */
1044enum wmi_scan_priority {
1045        WMI_SCAN_PRIORITY_VERY_LOW = 0,
1046        WMI_SCAN_PRIORITY_LOW,
1047        WMI_SCAN_PRIORITY_MEDIUM,
1048        WMI_SCAN_PRIORITY_HIGH,
1049        WMI_SCAN_PRIORITY_VERY_HIGH,
1050        WMI_SCAN_PRIORITY_COUNT   /* number of priorities supported */
1051};
1052
1053struct wmi_start_scan_cmd {
1054        /* Scan ID */
1055        __le32 scan_id;
1056        /* Scan requestor ID */
1057        __le32 scan_req_id;
1058        /* VDEV id(interface) that is requesting scan */
1059        __le32 vdev_id;
1060        /* Scan Priority, input to scan scheduler */
1061        __le32 scan_priority;
1062        /* Scan events subscription */
1063        __le32 notify_scan_events;
1064        /* dwell time in msec on active channels */
1065        __le32 dwell_time_active;
1066        /* dwell time in msec on passive channels */
1067        __le32 dwell_time_passive;
1068        /*
1069         * min time in msec on the BSS channel,only valid if atleast one
1070         * VDEV is active
1071         */
1072        __le32 min_rest_time;
1073        /*
1074         * max rest time in msec on the BSS channel,only valid if at least
1075         * one VDEV is active
1076         */
1077        /*
1078         * the scanner will rest on the bss channel at least min_rest_time
1079         * after min_rest_time the scanner will start checking for tx/rx
1080         * activity on all VDEVs. if there is no activity the scanner will
1081         * switch to off channel. if there is activity the scanner will let
1082         * the radio on the bss channel until max_rest_time expires.at
1083         * max_rest_time scanner will switch to off channel irrespective of
1084         * activity. activity is determined by the idle_time parameter.
1085         */
1086        __le32 max_rest_time;
1087        /*
1088         * time before sending next set of probe requests.
1089         * The scanner keeps repeating probe requests transmission with
1090         * period specified by repeat_probe_time.
1091         * The number of probe requests specified depends on the ssid_list
1092         * and bssid_list
1093         */
1094        __le32 repeat_probe_time;
1095        /* time in msec between 2 consequetive probe requests with in a set. */
1096        __le32 probe_spacing_time;
1097        /*
1098         * data inactivity time in msec on bss channel that will be used by
1099         * scanner for measuring the inactivity.
1100         */
1101        __le32 idle_time;
1102        /* maximum time in msec allowed for scan  */
1103        __le32 max_scan_time;
1104        /*
1105         * delay in msec before sending first probe request after switching
1106         * to a channel
1107         */
1108        __le32 probe_delay;
1109        /* Scan control flags */
1110        __le32 scan_ctrl_flags;
1111
1112        /* Burst duration time in msecs */
1113        __le32 burst_duration;
1114        /*
1115         * TLV (tag length value )  paramerters follow the scan_cmd structure.
1116         * TLV can contain channel list, bssid list, ssid list and
1117         * ie. the TLV tags are defined above;
1118         */
1119} __packed;
1120
1121struct wmi_ssid_arg {
1122        int len;
1123        const u8 *ssid;
1124};
1125
1126struct wmi_bssid_arg {
1127        const u8 *bssid;
1128};
1129
1130struct wmi_start_scan_arg {
1131        u32 scan_id;
1132        u32 scan_req_id;
1133        u32 vdev_id;
1134        u32 scan_priority;
1135        u32 notify_scan_events;
1136        u32 dwell_time_active;
1137        u32 dwell_time_passive;
1138        u32 min_rest_time;
1139        u32 max_rest_time;
1140        u32 repeat_probe_time;
1141        u32 probe_spacing_time;
1142        u32 idle_time;
1143        u32 max_scan_time;
1144        u32 probe_delay;
1145        u32 scan_ctrl_flags;
1146
1147        u32 ie_len;
1148        u32 n_channels;
1149        u32 n_ssids;
1150        u32 n_bssids;
1151
1152        u8 ie[WLAN_SCAN_PARAMS_MAX_IE_LEN];
1153        u32 channels[64];
1154        struct wmi_ssid_arg ssids[WLAN_SCAN_PARAMS_MAX_SSID];
1155        struct wmi_bssid_arg bssids[WLAN_SCAN_PARAMS_MAX_BSSID];
1156};
1157
1158/* scan control flags */
1159
1160/* passively scan all channels including active channels */
1161#define WMI_SCAN_FLAG_PASSIVE        0x1
1162/* add wild card ssid probe request even though ssid_list is specified. */
1163#define WMI_SCAN_ADD_BCAST_PROBE_REQ 0x2
1164/* add cck rates to rates/xrate ie for the generated probe request */
1165#define WMI_SCAN_ADD_CCK_RATES 0x4
1166/* add ofdm rates to rates/xrate ie for the generated probe request */
1167#define WMI_SCAN_ADD_OFDM_RATES 0x8
1168/* To enable indication of Chan load and Noise floor to host */
1169#define WMI_SCAN_CHAN_STAT_EVENT 0x10
1170/* Filter Probe request frames  */
1171#define WMI_SCAN_FILTER_PROBE_REQ 0x20
1172/* When set, DFS channels will not be scanned */
1173#define WMI_SCAN_BYPASS_DFS_CHN 0x40
1174/* Different FW scan engine may choose to bail out on errors.
1175 * Allow the driver to have influence over that. */
1176#define WMI_SCAN_CONTINUE_ON_ERROR 0x80
1177
1178/* WMI_SCAN_CLASS_MASK must be the same value as IEEE80211_SCAN_CLASS_MASK */
1179#define WMI_SCAN_CLASS_MASK 0xFF000000
1180
1181
1182enum wmi_stop_scan_type {
1183        WMI_SCAN_STOP_ONE       = 0x00000000, /* stop by scan_id */
1184        WMI_SCAN_STOP_VDEV_ALL  = 0x01000000, /* stop by vdev_id */
1185        WMI_SCAN_STOP_ALL       = 0x04000000, /* stop all scans */
1186};
1187
1188struct wmi_stop_scan_cmd {
1189        __le32 scan_req_id;
1190        __le32 scan_id;
1191        __le32 req_type;
1192        __le32 vdev_id;
1193} __packed;
1194
1195struct wmi_stop_scan_arg {
1196        u32 req_id;
1197        enum wmi_stop_scan_type req_type;
1198        union {
1199                u32 scan_id;
1200                u32 vdev_id;
1201        } u;
1202};
1203
1204struct wmi_scan_chan_list_cmd {
1205        __le32 num_scan_chans;
1206        struct wmi_channel chan_info[0];
1207} __packed;
1208
1209struct wmi_scan_chan_list_arg {
1210        u32 n_channels;
1211        struct wmi_channel_arg *channels;
1212};
1213
1214enum wmi_bss_filter {
1215        WMI_BSS_FILTER_NONE = 0,        /* no beacons forwarded */
1216        WMI_BSS_FILTER_ALL,             /* all beacons forwarded */
1217        WMI_BSS_FILTER_PROFILE,         /* only beacons matching profile */
1218        WMI_BSS_FILTER_ALL_BUT_PROFILE, /* all but beacons matching profile */
1219        WMI_BSS_FILTER_CURRENT_BSS,     /* only beacons matching current BSS */
1220        WMI_BSS_FILTER_ALL_BUT_BSS,     /* all but beacons matching BSS */
1221        WMI_BSS_FILTER_PROBED_SSID,     /* beacons matching probed ssid */
1222        WMI_BSS_FILTER_LAST_BSS,        /* marker only */
1223};
1224
1225enum wmi_scan_event_type {
1226        WMI_SCAN_EVENT_STARTED         = 0x1,
1227        WMI_SCAN_EVENT_COMPLETED       = 0x2,
1228        WMI_SCAN_EVENT_BSS_CHANNEL     = 0x4,
1229        WMI_SCAN_EVENT_FOREIGN_CHANNEL = 0x8,
1230        WMI_SCAN_EVENT_DEQUEUED        = 0x10,
1231        WMI_SCAN_EVENT_PREEMPTED       = 0x20, /* possibly by high-prio scan */
1232        WMI_SCAN_EVENT_START_FAILED    = 0x40,
1233        WMI_SCAN_EVENT_RESTARTED       = 0x80,
1234        WMI_SCAN_EVENT_MAX             = 0x8000
1235};
1236
1237enum wmi_scan_completion_reason {
1238        WMI_SCAN_REASON_COMPLETED,
1239        WMI_SCAN_REASON_CANCELLED,
1240        WMI_SCAN_REASON_PREEMPTED,
1241        WMI_SCAN_REASON_TIMEDOUT,
1242        WMI_SCAN_REASON_MAX,
1243};
1244
1245struct wmi_scan_event {
1246        __le32 event_type; /* %WMI_SCAN_EVENT_ */
1247        __le32 reason; /* %WMI_SCAN_REASON_ */
1248        __le32 channel_freq; /* only valid for WMI_SCAN_EVENT_FOREIGN_CHANNEL */
1249        __le32 scan_req_id;
1250        __le32 scan_id;
1251        __le32 vdev_id;
1252} __packed;
1253
1254/*
1255 * This defines how much headroom is kept in the
1256 * receive frame between the descriptor and the
1257 * payload, in order for the WMI PHY error and
1258 * management handler to insert header contents.
1259 *
1260 * This is in bytes.
1261 */
1262#define WMI_MGMT_RX_HDR_HEADROOM    52
1263
1264/*
1265 * This event will be used for sending scan results
1266 * as well as rx mgmt frames to the host. The rx buffer
1267 * will be sent as part of this WMI event. It would be a
1268 * good idea to pass all the fields in the RX status
1269 * descriptor up to the host.
1270 */
1271struct wmi_mgmt_rx_hdr {
1272        __le32 channel;
1273        __le32 snr;
1274        __le32 rate;
1275        __le32 phy_mode;
1276        __le32 buf_len;
1277        __le32 status; /* %WMI_RX_STATUS_ */
1278} __packed;
1279
1280struct wmi_mgmt_rx_event {
1281        struct wmi_mgmt_rx_hdr hdr;
1282        u8 buf[0];
1283} __packed;
1284
1285#define WMI_RX_STATUS_OK                        0x00
1286#define WMI_RX_STATUS_ERR_CRC                   0x01
1287#define WMI_RX_STATUS_ERR_DECRYPT               0x08
1288#define WMI_RX_STATUS_ERR_MIC                   0x10
1289#define WMI_RX_STATUS_ERR_KEY_CACHE_MISS        0x20
1290
1291struct wmi_single_phyerr_rx_hdr {
1292        /* TSF timestamp */
1293        __le32 tsf_timestamp;
1294
1295        /*
1296         * Current freq1, freq2
1297         *
1298         * [7:0]:    freq1[lo]
1299         * [15:8] :   freq1[hi]
1300         * [23:16]:   freq2[lo]
1301         * [31:24]:   freq2[hi]
1302         */
1303        __le16 freq1;
1304        __le16 freq2;
1305
1306        /*
1307         * Combined RSSI over all chains and channel width for this PHY error
1308         *
1309         * [7:0]: RSSI combined
1310         * [15:8]: Channel width (MHz)
1311         * [23:16]: PHY error code
1312         * [24:16]: reserved (future use)
1313         */
1314        u8 rssi_combined;
1315        u8 chan_width_mhz;
1316        u8 phy_err_code;
1317        u8 rsvd0;
1318
1319        /*
1320         * RSSI on chain 0 through 3
1321         *
1322         * This is formatted the same as the PPDU_START RX descriptor
1323         * field:
1324         *
1325         * [7:0]:   pri20
1326         * [15:8]:  sec20
1327         * [23:16]: sec40
1328         * [31:24]: sec80
1329         */
1330
1331        __le32 rssi_chain0;
1332        __le32 rssi_chain1;
1333        __le32 rssi_chain2;
1334        __le32 rssi_chain3;
1335
1336        /*
1337         * Last calibrated NF value for chain 0 through 3
1338         *
1339         * nf_list_1:
1340         *
1341         * + [15:0] - chain 0
1342         * + [31:16] - chain 1
1343         *
1344         * nf_list_2:
1345         *
1346         * + [15:0] - chain 2
1347         * + [31:16] - chain 3
1348         */
1349        __le32 nf_list_1;
1350        __le32 nf_list_2;
1351
1352
1353        /* Length of the frame */
1354        __le32 buf_len;
1355} __packed;
1356
1357struct wmi_single_phyerr_rx_event {
1358        /* Phy error event header */
1359        struct wmi_single_phyerr_rx_hdr hdr;
1360        /* frame buffer */
1361        u8 bufp[0];
1362} __packed;
1363
1364struct wmi_comb_phyerr_rx_hdr {
1365        /* Phy error phy error count */
1366        __le32 num_phyerr_events;
1367        __le32 tsf_l32;
1368        __le32 tsf_u32;
1369} __packed;
1370
1371struct wmi_comb_phyerr_rx_event {
1372        /* Phy error phy error count */
1373        struct wmi_comb_phyerr_rx_hdr hdr;
1374        /*
1375         * frame buffer - contains multiple payloads in the order:
1376         *                    header - payload, header - payload...
1377         *  (The header is of type: wmi_single_phyerr_rx_hdr)
1378         */
1379        u8 bufp[0];
1380} __packed;
1381
1382struct wmi_mgmt_tx_hdr {
1383        __le32 vdev_id;
1384        struct wmi_mac_addr peer_macaddr;
1385        __le32 tx_rate;
1386        __le32 tx_power;
1387        __le32 buf_len;
1388} __packed;
1389
1390struct wmi_mgmt_tx_cmd {
1391        struct wmi_mgmt_tx_hdr hdr;
1392        u8 buf[0];
1393} __packed;
1394
1395struct wmi_echo_event {
1396        __le32 value;
1397} __packed;
1398
1399struct wmi_echo_cmd {
1400        __le32 value;
1401} __packed;
1402
1403
1404struct wmi_pdev_set_regdomain_cmd {
1405        __le32 reg_domain;
1406        __le32 reg_domain_2G;
1407        __le32 reg_domain_5G;
1408        __le32 conformance_test_limit_2G;
1409        __le32 conformance_test_limit_5G;
1410} __packed;
1411
1412/* Command to set/unset chip in quiet mode */
1413struct wmi_pdev_set_quiet_cmd {
1414        /* period in TUs */
1415        __le32 period;
1416
1417        /* duration in TUs */
1418        __le32 duration;
1419
1420        /* offset in TUs */
1421        __le32 next_start;
1422
1423        /* enable/disable */
1424        __le32 enabled;
1425} __packed;
1426
1427
1428/*
1429 * 802.11g protection mode.
1430 */
1431enum ath10k_protmode {
1432        ATH10K_PROT_NONE     = 0,    /* no protection */
1433        ATH10K_PROT_CTSONLY  = 1,    /* CTS to self */
1434        ATH10K_PROT_RTSCTS   = 2,    /* RTS-CTS */
1435};
1436
1437enum wmi_beacon_gen_mode {
1438        WMI_BEACON_STAGGERED_MODE = 0,
1439        WMI_BEACON_BURST_MODE = 1
1440};
1441
1442enum wmi_csa_event_ies_present_flag {
1443        WMI_CSA_IE_PRESENT = 0x00000001,
1444        WMI_XCSA_IE_PRESENT = 0x00000002,
1445        WMI_WBW_IE_PRESENT = 0x00000004,
1446        WMI_CSWARP_IE_PRESENT = 0x00000008,
1447};
1448
1449/* wmi CSA receive event from beacon frame */
1450struct wmi_csa_event {
1451        __le32 i_fc_dur;
1452        /* Bit 0-15: FC */
1453        /* Bit 16-31: DUR */
1454        struct wmi_mac_addr i_addr1;
1455        struct wmi_mac_addr i_addr2;
1456        __le32 csa_ie[2];
1457        __le32 xcsa_ie[2];
1458        __le32 wb_ie[2];
1459        __le32 cswarp_ie;
1460        __le32 ies_present_flag; /* wmi_csa_event_ies_present_flag */
1461} __packed;
1462
1463/* the definition of different PDEV parameters */
1464#define PDEV_DEFAULT_STATS_UPDATE_PERIOD    500
1465#define VDEV_DEFAULT_STATS_UPDATE_PERIOD    500
1466#define PEER_DEFAULT_STATS_UPDATE_PERIOD    500
1467
1468enum wmi_pdev_param {
1469        /* TX chian mask */
1470        WMI_PDEV_PARAM_TX_CHAIN_MASK = 0x1,
1471        /* RX chian mask */
1472        WMI_PDEV_PARAM_RX_CHAIN_MASK,
1473        /* TX power limit for 2G Radio */
1474        WMI_PDEV_PARAM_TXPOWER_LIMIT2G,
1475        /* TX power limit for 5G Radio */
1476        WMI_PDEV_PARAM_TXPOWER_LIMIT5G,
1477        /* TX power scale */
1478        WMI_PDEV_PARAM_TXPOWER_SCALE,
1479        /* Beacon generation mode . 0: host, 1: target   */
1480        WMI_PDEV_PARAM_BEACON_GEN_MODE,
1481        /* Beacon generation mode . 0: staggered 1: bursted   */
1482        WMI_PDEV_PARAM_BEACON_TX_MODE,
1483        /*
1484         * Resource manager off chan mode .
1485         * 0: turn off off chan mode. 1: turn on offchan mode
1486         */
1487        WMI_PDEV_PARAM_RESMGR_OFFCHAN_MODE,
1488        /*
1489         * Protection mode:
1490         * 0: no protection 1:use CTS-to-self 2: use RTS/CTS
1491         */
1492        WMI_PDEV_PARAM_PROTECTION_MODE,
1493        /* Dynamic bandwidth 0: disable 1: enable */
1494        WMI_PDEV_PARAM_DYNAMIC_BW,
1495        /* Non aggregrate/ 11g sw retry threshold.0-disable */
1496        WMI_PDEV_PARAM_NON_AGG_SW_RETRY_TH,
1497        /* aggregrate sw retry threshold. 0-disable*/
1498        WMI_PDEV_PARAM_AGG_SW_RETRY_TH,
1499        /* Station kickout threshold (non of consecutive failures).0-disable */
1500        WMI_PDEV_PARAM_STA_KICKOUT_TH,
1501        /* Aggerate size scaling configuration per AC */
1502        WMI_PDEV_PARAM_AC_AGGRSIZE_SCALING,
1503        /* LTR enable */
1504        WMI_PDEV_PARAM_LTR_ENABLE,
1505        /* LTR latency for BE, in us */
1506        WMI_PDEV_PARAM_LTR_AC_LATENCY_BE,
1507        /* LTR latency for BK, in us */
1508        WMI_PDEV_PARAM_LTR_AC_LATENCY_BK,
1509        /* LTR latency for VI, in us */
1510        WMI_PDEV_PARAM_LTR_AC_LATENCY_VI,
1511        /* LTR latency for VO, in us  */
1512        WMI_PDEV_PARAM_LTR_AC_LATENCY_VO,
1513        /* LTR AC latency timeout, in ms */
1514        WMI_PDEV_PARAM_LTR_AC_LATENCY_TIMEOUT,
1515        /* LTR platform latency override, in us */
1516        WMI_PDEV_PARAM_LTR_SLEEP_OVERRIDE,
1517        /* LTR-RX override, in us */
1518        WMI_PDEV_PARAM_LTR_RX_OVERRIDE,
1519        /* Tx activity timeout for LTR, in us */
1520        WMI_PDEV_PARAM_LTR_TX_ACTIVITY_TIMEOUT,
1521        /* L1SS state machine enable */
1522        WMI_PDEV_PARAM_L1SS_ENABLE,
1523        /* Deep sleep state machine enable */
1524        WMI_PDEV_PARAM_DSLEEP_ENABLE,
1525        /* RX buffering flush enable */
1526        WMI_PDEV_PARAM_PCIELP_TXBUF_FLUSH,
1527        /* RX buffering matermark */
1528        WMI_PDEV_PARAM_PCIELP_TXBUF_WATERMARK,
1529        /* RX buffering timeout enable */
1530        WMI_PDEV_PARAM_PCIELP_TXBUF_TMO_EN,
1531        /* RX buffering timeout value */
1532        WMI_PDEV_PARAM_PCIELP_TXBUF_TMO_VALUE,
1533        /* pdev level stats update period in ms */
1534        WMI_PDEV_PARAM_PDEV_STATS_UPDATE_PERIOD,
1535        /* vdev level stats update period in ms */
1536        WMI_PDEV_PARAM_VDEV_STATS_UPDATE_PERIOD,
1537        /* peer level stats update period in ms */
1538        WMI_PDEV_PARAM_PEER_STATS_UPDATE_PERIOD,
1539        /* beacon filter status update period */
1540        WMI_PDEV_PARAM_BCNFLT_STATS_UPDATE_PERIOD,
1541        /* QOS Mgmt frame protection MFP/PMF 0: disable, 1: enable */
1542        WMI_PDEV_PARAM_PMF_QOS,
1543        /* Access category on which ARP frames are sent */
1544        WMI_PDEV_PARAM_ARP_AC_OVERRIDE,
1545        /* DCS configuration */
1546        WMI_PDEV_PARAM_DCS,
1547        /* Enable/Disable ANI on target */
1548        WMI_PDEV_PARAM_ANI_ENABLE,
1549        /* configure the ANI polling period */
1550        WMI_PDEV_PARAM_ANI_POLL_PERIOD,
1551        /* configure the ANI listening period */
1552        WMI_PDEV_PARAM_ANI_LISTEN_PERIOD,
1553        /* configure OFDM immunity level */
1554        WMI_PDEV_PARAM_ANI_OFDM_LEVEL,
1555        /* configure CCK immunity level */
1556        WMI_PDEV_PARAM_ANI_CCK_LEVEL,
1557        /* Enable/Disable CDD for 1x1 STAs in rate control module */
1558        WMI_PDEV_PARAM_DYNTXCHAIN,
1559        /* Enable/Disable proxy STA */
1560        WMI_PDEV_PARAM_PROXY_STA,
1561        /* Enable/Disable low power state when all VDEVs are inactive/idle. */
1562        WMI_PDEV_PARAM_IDLE_PS_CONFIG,
1563        /* Enable/Disable power gating sleep */
1564        WMI_PDEV_PARAM_POWER_GATING_SLEEP,
1565};
1566
1567struct wmi_pdev_set_param_cmd {
1568        __le32 param_id;
1569        __le32 param_value;
1570} __packed;
1571
1572struct wmi_pdev_get_tpc_config_cmd {
1573        /* parameter   */
1574        __le32 param;
1575} __packed;
1576
1577#define WMI_TPC_RATE_MAX                160
1578#define WMI_TPC_TX_N_CHAIN              4
1579
1580enum wmi_tpc_config_event_flag {
1581        WMI_TPC_CONFIG_EVENT_FLAG_TABLE_CDD     = 0x1,
1582        WMI_TPC_CONFIG_EVENT_FLAG_TABLE_STBC    = 0x2,
1583        WMI_TPC_CONFIG_EVENT_FLAG_TABLE_TXBF    = 0x4,
1584};
1585
1586struct wmi_pdev_tpc_config_event {
1587        __le32 reg_domain;
1588        __le32 chan_freq;
1589        __le32 phy_mode;
1590        __le32 twice_antenna_reduction;
1591        __le32 twice_max_rd_power;
1592        s32 twice_antenna_gain;
1593        __le32 power_limit;
1594        __le32 rate_max;
1595        __le32 num_tx_chain;
1596        __le32 ctl;
1597        __le32 flags;
1598        s8 max_reg_allow_pow[WMI_TPC_TX_N_CHAIN];
1599        s8 max_reg_allow_pow_agcdd[WMI_TPC_TX_N_CHAIN][WMI_TPC_TX_N_CHAIN];
1600        s8 max_reg_allow_pow_agstbc[WMI_TPC_TX_N_CHAIN][WMI_TPC_TX_N_CHAIN];
1601        s8 max_reg_allow_pow_agtxbf[WMI_TPC_TX_N_CHAIN][WMI_TPC_TX_N_CHAIN];
1602        u8 rates_array[WMI_TPC_RATE_MAX];
1603} __packed;
1604
1605/* Transmit power scale factor. */
1606enum wmi_tp_scale {
1607        WMI_TP_SCALE_MAX    = 0,        /* no scaling (default) */
1608        WMI_TP_SCALE_50     = 1,        /* 50% of max (-3 dBm) */
1609        WMI_TP_SCALE_25     = 2,        /* 25% of max (-6 dBm) */
1610        WMI_TP_SCALE_12     = 3,        /* 12% of max (-9 dBm) */
1611        WMI_TP_SCALE_MIN    = 4,        /* min, but still on   */
1612        WMI_TP_SCALE_SIZE   = 5,        /* max num of enum     */
1613};
1614
1615struct wmi_set_channel_cmd {
1616        /* channel (only frequency and mode info are used) */
1617        struct wmi_channel chan;
1618} __packed;
1619
1620struct wmi_pdev_chanlist_update_event {
1621        /* number of channels */
1622        __le32 num_chan;
1623        /* array of channels */
1624        struct wmi_channel channel_list[1];
1625} __packed;
1626
1627#define WMI_MAX_DEBUG_MESG (sizeof(u32) * 32)
1628
1629struct wmi_debug_mesg_event {
1630        /* message buffer, NULL terminated */
1631        char bufp[WMI_MAX_DEBUG_MESG];
1632} __packed;
1633
1634enum {
1635        /* P2P device */
1636        VDEV_SUBTYPE_P2PDEV = 0,
1637        /* P2P client */
1638        VDEV_SUBTYPE_P2PCLI,
1639        /* P2P GO */
1640        VDEV_SUBTYPE_P2PGO,
1641        /* BT3.0 HS */
1642        VDEV_SUBTYPE_BT,
1643};
1644
1645struct wmi_pdev_set_channel_cmd {
1646        /* idnore power , only use flags , mode and freq */
1647        struct wmi_channel chan;
1648} __packed;
1649
1650/* Customize the DSCP (bit) to TID (0-7) mapping for QOS */
1651#define WMI_DSCP_MAP_MAX    (64)
1652struct wmi_pdev_set_dscp_tid_map_cmd {
1653        /* map indicating DSCP to TID conversion */
1654        __le32 dscp_to_tid_map[WMI_DSCP_MAP_MAX];
1655} __packed;
1656
1657enum mcast_bcast_rate_id {
1658        WMI_SET_MCAST_RATE,
1659        WMI_SET_BCAST_RATE
1660};
1661
1662struct mcast_bcast_rate {
1663        enum mcast_bcast_rate_id rate_id;
1664        __le32 rate;
1665} __packed;
1666
1667struct wmi_wmm_params {
1668        __le32 cwmin;
1669        __le32 cwmax;
1670        __le32 aifs;
1671        __le32 txop;
1672        __le32 acm;
1673        __le32 no_ack;
1674} __packed;
1675
1676struct wmi_pdev_set_wmm_params {
1677        struct wmi_wmm_params ac_be;
1678        struct wmi_wmm_params ac_bk;
1679        struct wmi_wmm_params ac_vi;
1680        struct wmi_wmm_params ac_vo;
1681} __packed;
1682
1683struct wmi_wmm_params_arg {
1684        u32 cwmin;
1685        u32 cwmax;
1686        u32 aifs;
1687        u32 txop;
1688        u32 acm;
1689        u32 no_ack;
1690};
1691
1692struct wmi_pdev_set_wmm_params_arg {
1693        struct wmi_wmm_params_arg ac_be;
1694        struct wmi_wmm_params_arg ac_bk;
1695        struct wmi_wmm_params_arg ac_vi;
1696        struct wmi_wmm_params_arg ac_vo;
1697};
1698
1699struct wal_dbg_tx_stats {
1700        /* Num HTT cookies queued to dispatch list */
1701        __le32 comp_queued;
1702
1703        /* Num HTT cookies dispatched */
1704        __le32 comp_delivered;
1705
1706        /* Num MSDU queued to WAL */
1707        __le32 msdu_enqued;
1708
1709        /* Num MPDU queue to WAL */
1710        __le32 mpdu_enqued;
1711
1712        /* Num MSDUs dropped by WMM limit */
1713        __le32 wmm_drop;
1714
1715        /* Num Local frames queued */
1716        __le32 local_enqued;
1717
1718        /* Num Local frames done */
1719        __le32 local_freed;
1720
1721        /* Num queued to HW */
1722        __le32 hw_queued;
1723
1724        /* Num PPDU reaped from HW */
1725        __le32 hw_reaped;
1726
1727        /* Num underruns */
1728        __le32 underrun;
1729
1730        /* Num PPDUs cleaned up in TX abort */
1731        __le32 tx_abort;
1732
1733        /* Num MPDUs requed by SW */
1734        __le32 mpdus_requed;
1735
1736        /* excessive retries */
1737        __le32 tx_ko;
1738
1739        /* data hw rate code */
1740        __le32 data_rc;
1741
1742        /* Scheduler self triggers */
1743        __le32 self_triggers;
1744
1745        /* frames dropped due to excessive sw retries */
1746        __le32 sw_retry_failure;
1747
1748        /* illegal rate phy errors  */
1749        __le32 illgl_rate_phy_err;
1750
1751        /* wal pdev continous xretry */
1752        __le32 pdev_cont_xretry;
1753
1754        /* wal pdev continous xretry */
1755        __le32 pdev_tx_timeout;
1756
1757        /* wal pdev resets  */
1758        __le32 pdev_resets;
1759
1760        __le32 phy_underrun;
1761
1762        /* MPDU is more than txop limit */
1763        __le32 txop_ovf;
1764} __packed;
1765
1766struct wal_dbg_rx_stats {
1767        /* Cnts any change in ring routing mid-ppdu */
1768        __le32 mid_ppdu_route_change;
1769
1770        /* Total number of statuses processed */
1771        __le32 status_rcvd;
1772
1773        /* Extra frags on rings 0-3 */
1774        __le32 r0_frags;
1775        __le32 r1_frags;
1776        __le32 r2_frags;
1777        __le32 r3_frags;
1778
1779        /* MSDUs / MPDUs delivered to HTT */
1780        __le32 htt_msdus;
1781        __le32 htt_mpdus;
1782
1783        /* MSDUs / MPDUs delivered to local stack */
1784        __le32 loc_msdus;
1785        __le32 loc_mpdus;
1786
1787        /* AMSDUs that have more MSDUs than the status ring size */
1788        __le32 oversize_amsdu;
1789
1790        /* Number of PHY errors */
1791        __le32 phy_errs;
1792
1793        /* Number of PHY errors drops */
1794        __le32 phy_err_drop;
1795
1796        /* Number of mpdu errors - FCS, MIC, ENC etc. */
1797        __le32 mpdu_errs;
1798} __packed;
1799
1800struct wal_dbg_peer_stats {
1801        /* REMOVE THIS ONCE REAL PEER STAT COUNTERS ARE ADDED */
1802        __le32 dummy;
1803} __packed;
1804
1805struct wal_dbg_stats {
1806        struct wal_dbg_tx_stats tx;
1807        struct wal_dbg_rx_stats rx;
1808        struct wal_dbg_peer_stats peer;
1809} __packed;
1810
1811enum wmi_stats_id {
1812        WMI_REQUEST_PEER_STAT   = 0x01,
1813        WMI_REQUEST_AP_STAT     = 0x02
1814};
1815
1816struct wmi_request_stats_cmd {
1817        __le32 stats_id;
1818
1819        /*
1820         * Space to add parameters like
1821         * peer mac addr
1822         */
1823} __packed;
1824
1825/* Suspend option */
1826enum {
1827        /* suspend */
1828        WMI_PDEV_SUSPEND,
1829
1830        /* suspend and disable all interrupts */
1831        WMI_PDEV_SUSPEND_AND_DISABLE_INTR,
1832};
1833
1834struct wmi_pdev_suspend_cmd {
1835        /* suspend option sent to target */
1836        __le32 suspend_opt;
1837} __packed;
1838
1839struct wmi_stats_event {
1840        __le32 stats_id; /* %WMI_REQUEST_ */
1841        /*
1842         * number of pdev stats event structures
1843         * (wmi_pdev_stats) 0 or 1
1844         */
1845        __le32 num_pdev_stats;
1846        /*
1847         * number of vdev stats event structures
1848         * (wmi_vdev_stats) 0 or max vdevs
1849         */
1850        __le32 num_vdev_stats;
1851        /*
1852         * number of peer stats event structures
1853         * (wmi_peer_stats) 0 or max peers
1854         */
1855        __le32 num_peer_stats;
1856        __le32 num_bcnflt_stats;
1857        /*
1858         * followed by
1859         *   num_pdev_stats * size of(struct wmi_pdev_stats)
1860         *   num_vdev_stats * size of(struct wmi_vdev_stats)
1861         *   num_peer_stats * size of(struct wmi_peer_stats)
1862         *
1863         *  By having a zero sized array, the pointer to data area
1864         *  becomes available without increasing the struct size
1865         */
1866        u8 data[0];
1867} __packed;
1868
1869/*
1870 * PDEV statistics
1871 * TODO: add all PDEV stats here
1872 */
1873struct wmi_pdev_stats {
1874        __le32 chan_nf;        /* Channel noise floor */
1875        __le32 tx_frame_count; /* TX frame count */
1876        __le32 rx_frame_count; /* RX frame count */
1877        __le32 rx_clear_count; /* rx clear count */
1878        __le32 cycle_count;    /* cycle count */
1879        __le32 phy_err_count;  /* Phy error count */
1880        __le32 chan_tx_pwr;    /* channel tx power */
1881        struct wal_dbg_stats wal; /* WAL dbg stats */
1882} __packed;
1883
1884/*
1885 * VDEV statistics
1886 * TODO: add all VDEV stats here
1887 */
1888struct wmi_vdev_stats {
1889        __le32 vdev_id;
1890} __packed;
1891
1892/*
1893 * peer statistics.
1894 * TODO: add more stats
1895 */
1896struct wmi_peer_stats {
1897        struct wmi_mac_addr peer_macaddr;
1898        __le32 peer_rssi;
1899        __le32 peer_tx_rate;
1900} __packed;
1901
1902struct wmi_vdev_create_cmd {
1903        __le32 vdev_id;
1904        __le32 vdev_type;
1905        __le32 vdev_subtype;
1906        struct wmi_mac_addr vdev_macaddr;
1907} __packed;
1908
1909enum wmi_vdev_type {
1910        WMI_VDEV_TYPE_AP      = 1,
1911        WMI_VDEV_TYPE_STA     = 2,
1912        WMI_VDEV_TYPE_IBSS    = 3,
1913        WMI_VDEV_TYPE_MONITOR = 4,
1914};
1915
1916enum wmi_vdev_subtype {
1917        WMI_VDEV_SUBTYPE_NONE       = 0,
1918        WMI_VDEV_SUBTYPE_P2P_DEVICE = 1,
1919        WMI_VDEV_SUBTYPE_P2P_CLIENT = 2,
1920        WMI_VDEV_SUBTYPE_P2P_GO     = 3,
1921};
1922
1923/* values for vdev_subtype */
1924
1925/* values for vdev_start_request flags */
1926/*
1927 * Indicates that AP VDEV uses hidden ssid. only valid for
1928 *  AP/GO */
1929#define WMI_VDEV_START_HIDDEN_SSID  (1<<0)
1930/*
1931 * Indicates if robust management frame/management frame
1932 *  protection is enabled. For GO/AP vdevs, it indicates that
1933 *  it may support station/client associations with RMF enabled.
1934 *  For STA/client vdevs, it indicates that sta will
1935 *  associate with AP with RMF enabled. */
1936#define WMI_VDEV_START_PMF_ENABLED  (1<<1)
1937
1938struct wmi_p2p_noa_descriptor {
1939        __le32 type_count; /* 255: continuous schedule, 0: reserved */
1940        __le32 duration;  /* Absent period duration in micro seconds */
1941        __le32 interval;   /* Absent period interval in micro seconds */
1942        __le32 start_time; /* 32 bit tsf time when in starts */
1943} __packed;
1944
1945struct wmi_vdev_start_request_cmd {
1946        /* WMI channel */
1947        struct wmi_channel chan;
1948        /* unique id identifying the VDEV, generated by the caller */
1949        __le32 vdev_id;
1950        /* requestor id identifying the caller module */
1951        __le32 requestor_id;
1952        /* beacon interval from received beacon */
1953        __le32 beacon_interval;
1954        /* DTIM Period from the received beacon */
1955        __le32 dtim_period;
1956        /* Flags */
1957        __le32 flags;
1958        /* ssid field. Only valid for AP/GO/IBSS/BTAmp VDEV type. */
1959        struct wmi_ssid ssid;
1960        /* beacon/probe reponse xmit rate. Applicable for SoftAP. */
1961        __le32 bcn_tx_rate;
1962        /* beacon/probe reponse xmit power. Applicable for SoftAP. */
1963        __le32 bcn_tx_power;
1964        /* number of p2p NOA descriptor(s) from scan entry */
1965        __le32 num_noa_descriptors;
1966        /*
1967         * Disable H/W ack. This used by WMI_VDEV_RESTART_REQUEST_CMDID.
1968         * During CAC, Our HW shouldn't ack ditected frames
1969         */
1970        __le32 disable_hw_ack;
1971        /* actual p2p NOA descriptor from scan entry */
1972        struct wmi_p2p_noa_descriptor noa_descriptors[2];
1973} __packed;
1974
1975struct wmi_vdev_restart_request_cmd {
1976        struct wmi_vdev_start_request_cmd vdev_start_request_cmd;
1977} __packed;
1978
1979struct wmi_vdev_start_request_arg {
1980        u32 vdev_id;
1981        struct wmi_channel_arg channel;
1982        u32 bcn_intval;
1983        u32 dtim_period;
1984        u8 *ssid;
1985        u32 ssid_len;
1986        u32 bcn_tx_rate;
1987        u32 bcn_tx_power;
1988        bool disable_hw_ack;
1989        bool hidden_ssid;
1990        bool pmf_enabled;
1991};
1992
1993struct wmi_vdev_delete_cmd {
1994        /* unique id identifying the VDEV, generated by the caller */
1995        __le32 vdev_id;
1996} __packed;
1997
1998struct wmi_vdev_up_cmd {
1999        __le32 vdev_id;
2000        __le32 vdev_assoc_id;
2001        struct wmi_mac_addr vdev_bssid;
2002} __packed;
2003
2004struct wmi_vdev_stop_cmd {
2005        __le32 vdev_id;
2006} __packed;
2007
2008struct wmi_vdev_down_cmd {
2009        __le32 vdev_id;
2010} __packed;
2011
2012struct wmi_vdev_standby_response_cmd {
2013        /* unique id identifying the VDEV, generated by the caller */
2014        __le32 vdev_id;
2015} __packed;
2016
2017struct wmi_vdev_resume_response_cmd {
2018        /* unique id identifying the VDEV, generated by the caller */
2019        __le32 vdev_id;
2020} __packed;
2021
2022struct wmi_vdev_set_param_cmd {
2023        __le32 vdev_id;
2024        __le32 param_id;
2025        __le32 param_value;
2026} __packed;
2027
2028#define WMI_MAX_KEY_INDEX   3
2029#define WMI_MAX_KEY_LEN     32
2030
2031#define WMI_KEY_PAIRWISE 0x00
2032#define WMI_KEY_GROUP    0x01
2033#define WMI_KEY_TX_USAGE 0x02 /* default tx key - static wep */
2034
2035struct wmi_key_seq_counter {
2036        __le32 key_seq_counter_l;
2037        __le32 key_seq_counter_h;
2038} __packed;
2039
2040#define WMI_CIPHER_NONE     0x0 /* clear key */
2041#define WMI_CIPHER_WEP      0x1
2042#define WMI_CIPHER_TKIP     0x2
2043#define WMI_CIPHER_AES_OCB  0x3
2044#define WMI_CIPHER_AES_CCM  0x4
2045#define WMI_CIPHER_WAPI     0x5
2046#define WMI_CIPHER_CKIP     0x6
2047#define WMI_CIPHER_AES_CMAC 0x7
2048
2049struct wmi_vdev_install_key_cmd {
2050        __le32 vdev_id;
2051        struct wmi_mac_addr peer_macaddr;
2052        __le32 key_idx;
2053        __le32 key_flags;
2054        __le32 key_cipher; /* %WMI_CIPHER_ */
2055        struct wmi_key_seq_counter key_rsc_counter;
2056        struct wmi_key_seq_counter key_global_rsc_counter;
2057        struct wmi_key_seq_counter key_tsc_counter;
2058        u8 wpi_key_rsc_counter[16];
2059        u8 wpi_key_tsc_counter[16];
2060        __le32 key_len;
2061        __le32 key_txmic_len;
2062        __le32 key_rxmic_len;
2063
2064        /* contains key followed by tx mic followed by rx mic */
2065        u8 key_data[0];
2066} __packed;
2067
2068struct wmi_vdev_install_key_arg {
2069        u32 vdev_id;
2070        const u8 *macaddr;
2071        u32 key_idx;
2072        u32 key_flags;
2073        u32 key_cipher;
2074        u32 key_len;
2075        u32 key_txmic_len;
2076        u32 key_rxmic_len;
2077        const void *key_data;
2078};
2079
2080/* Preamble types to be used with VDEV fixed rate configuration */
2081enum wmi_rate_preamble {
2082        WMI_RATE_PREAMBLE_OFDM,
2083        WMI_RATE_PREAMBLE_CCK,
2084        WMI_RATE_PREAMBLE_HT,
2085        WMI_RATE_PREAMBLE_VHT,
2086};
2087
2088/* Value to disable fixed rate setting */
2089#define WMI_FIXED_RATE_NONE    (0xff)
2090
2091/* the definition of different VDEV parameters */
2092enum wmi_vdev_param {
2093        /* RTS Threshold */
2094        WMI_VDEV_PARAM_RTS_THRESHOLD = 0x1,
2095        /* Fragmentation threshold */
2096        WMI_VDEV_PARAM_FRAGMENTATION_THRESHOLD,
2097        /* beacon interval in TUs */
2098        WMI_VDEV_PARAM_BEACON_INTERVAL,
2099        /* Listen interval in TUs */
2100        WMI_VDEV_PARAM_LISTEN_INTERVAL,
2101        /* muticast rate in Mbps */
2102        WMI_VDEV_PARAM_MULTICAST_RATE,
2103        /* management frame rate in Mbps */
2104        WMI_VDEV_PARAM_MGMT_TX_RATE,
2105        /* slot time (long vs short) */
2106        WMI_VDEV_PARAM_SLOT_TIME,
2107        /* preamble (long vs short) */
2108        WMI_VDEV_PARAM_PREAMBLE,
2109        /* SWBA time (time before tbtt in msec) */
2110        WMI_VDEV_PARAM_SWBA_TIME,
2111        /* time period for updating VDEV stats */
2112        WMI_VDEV_STATS_UPDATE_PERIOD,
2113        /* age out time in msec for frames queued for station in power save */
2114        WMI_VDEV_PWRSAVE_AGEOUT_TIME,
2115        /*
2116         * Host SWBA interval (time in msec before tbtt for SWBA event
2117         * generation).
2118         */
2119        WMI_VDEV_HOST_SWBA_INTERVAL,
2120        /* DTIM period (specified in units of num beacon intervals) */
2121        WMI_VDEV_PARAM_DTIM_PERIOD,
2122        /*
2123         * scheduler air time limit for this VDEV. used by off chan
2124         * scheduler.
2125         */
2126        WMI_VDEV_OC_SCHEDULER_AIR_TIME_LIMIT,
2127        /* enable/dsiable WDS for this VDEV  */
2128        WMI_VDEV_PARAM_WDS,
2129        /* ATIM Window */
2130        WMI_VDEV_PARAM_ATIM_WINDOW,
2131        /* BMISS max */
2132        WMI_VDEV_PARAM_BMISS_COUNT_MAX,
2133        /* BMISS first time */
2134        WMI_VDEV_PARAM_BMISS_FIRST_BCNT,
2135        /* BMISS final time */
2136        WMI_VDEV_PARAM_BMISS_FINAL_BCNT,
2137        /* WMM enables/disabled */
2138        WMI_VDEV_PARAM_FEATURE_WMM,
2139        /* Channel width */
2140        WMI_VDEV_PARAM_CHWIDTH,
2141        /* Channel Offset */
2142        WMI_VDEV_PARAM_CHEXTOFFSET,
2143        /* Disable HT Protection */
2144        WMI_VDEV_PARAM_DISABLE_HTPROTECTION,
2145        /* Quick STA Kickout */
2146        WMI_VDEV_PARAM_STA_QUICKKICKOUT,
2147        /* Rate to be used with Management frames */
2148        WMI_VDEV_PARAM_MGMT_RATE,
2149        /* Protection Mode */
2150        WMI_VDEV_PARAM_PROTECTION_MODE,
2151        /* Fixed rate setting */
2152        WMI_VDEV_PARAM_FIXED_RATE,
2153        /* Short GI Enable/Disable */
2154        WMI_VDEV_PARAM_SGI,
2155        /* Enable LDPC */
2156        WMI_VDEV_PARAM_LDPC,
2157        /* Enable Tx STBC */
2158        WMI_VDEV_PARAM_TX_STBC,
2159        /* Enable Rx STBC */
2160        WMI_VDEV_PARAM_RX_STBC,
2161        /* Intra BSS forwarding  */
2162        WMI_VDEV_PARAM_INTRA_BSS_FWD,
2163        /* Setting Default xmit key for Vdev */
2164        WMI_VDEV_PARAM_DEF_KEYID,
2165        /* NSS width */
2166        WMI_VDEV_PARAM_NSS,
2167        /* Set the custom rate for the broadcast data frames */
2168        WMI_VDEV_PARAM_BCAST_DATA_RATE,
2169        /* Set the custom rate (rate-code) for multicast data frames */
2170        WMI_VDEV_PARAM_MCAST_DATA_RATE,
2171        /* Tx multicast packet indicate Enable/Disable */
2172        WMI_VDEV_PARAM_MCAST_INDICATE,
2173        /* Tx DHCP packet indicate Enable/Disable */
2174        WMI_VDEV_PARAM_DHCP_INDICATE,
2175        /* Enable host inspection of Tx unicast packet to unknown destination */
2176        WMI_VDEV_PARAM_UNKNOWN_DEST_INDICATE,
2177
2178        /* The minimum amount of time AP begins to consider STA inactive */
2179        WMI_VDEV_PARAM_AP_KEEPALIVE_MIN_IDLE_INACTIVE_TIME_SECS,
2180
2181        /*
2182         * An associated STA is considered inactive when there is no recent
2183         * TX/RX activity and no downlink frames are buffered for it. Once a
2184         * STA exceeds the maximum idle inactive time, the AP will send an
2185         * 802.11 data-null as a keep alive to verify the STA is still
2186         * associated. If the STA does ACK the data-null, or if the data-null
2187         * is buffered and the STA does not retrieve it, the STA will be
2188         * considered unresponsive
2189         * (see WMI_VDEV_AP_KEEPALIVE_MAX_UNRESPONSIVE_TIME_SECS).
2190         */
2191        WMI_VDEV_PARAM_AP_KEEPALIVE_MAX_IDLE_INACTIVE_TIME_SECS,
2192
2193        /*
2194         * An associated STA is considered unresponsive if there is no recent
2195         * TX/RX activity and downlink frames are buffered for it. Once a STA
2196         * exceeds the maximum unresponsive time, the AP will send a
2197         * WMI_STA_KICKOUT event to the host so the STA can be deleted. */
2198        WMI_VDEV_PARAM_AP_KEEPALIVE_MAX_UNRESPONSIVE_TIME_SECS,
2199
2200        /* Enable NAWDS : MCAST INSPECT Enable, NAWDS Flag set */
2201        WMI_VDEV_PARAM_AP_ENABLE_NAWDS,
2202        /* Enable/Disable RTS-CTS */
2203        WMI_VDEV_PARAM_ENABLE_RTSCTS,
2204        /* Enable TXBFee/er */
2205        WMI_VDEV_PARAM_TXBF,
2206
2207        /* Set packet power save */
2208        WMI_VDEV_PARAM_PACKET_POWERSAVE,
2209
2210        /*
2211         * Drops un-encrypted packets if eceived in an encrypted connection
2212         * otherwise forwards to host.
2213         */
2214        WMI_VDEV_PARAM_DROP_UNENCRY,
2215
2216        /*
2217         * Set the encapsulation type for frames.
2218         */
2219        WMI_VDEV_PARAM_TX_ENCAP_TYPE,
2220};
2221
2222/* slot time long */
2223#define WMI_VDEV_SLOT_TIME_LONG         0x1
2224/* slot time short */
2225#define WMI_VDEV_SLOT_TIME_SHORT        0x2
2226/* preablbe long */
2227#define WMI_VDEV_PREAMBLE_LONG          0x1
2228/* preablbe short */
2229#define WMI_VDEV_PREAMBLE_SHORT         0x2
2230
2231enum wmi_start_event_param {
2232        WMI_VDEV_RESP_START_EVENT = 0,
2233        WMI_VDEV_RESP_RESTART_EVENT,
2234};
2235
2236struct wmi_vdev_start_response_event {
2237        __le32 vdev_id;
2238        __le32 req_id;
2239        __le32 resp_type; /* %WMI_VDEV_RESP_ */
2240        __le32 status;
2241} __packed;
2242
2243struct wmi_vdev_standby_req_event {
2244        /* unique id identifying the VDEV, generated by the caller */
2245        __le32 vdev_id;
2246} __packed;
2247
2248struct wmi_vdev_resume_req_event {
2249        /* unique id identifying the VDEV, generated by the caller */
2250        __le32 vdev_id;
2251} __packed;
2252
2253struct wmi_vdev_stopped_event {
2254        /* unique id identifying the VDEV, generated by the caller */
2255        __le32 vdev_id;
2256} __packed;
2257
2258/*
2259 * common structure used for simple events
2260 * (stopped, resume_req, standby response)
2261 */
2262struct wmi_vdev_simple_event {
2263        /* unique id identifying the VDEV, generated by the caller */
2264        __le32 vdev_id;
2265} __packed;
2266
2267/* VDEV start response status codes */
2268/* VDEV succesfully started */
2269#define WMI_INIFIED_VDEV_START_RESPONSE_STATUS_SUCCESS  0x0
2270
2271/* requested VDEV not found */
2272#define WMI_INIFIED_VDEV_START_RESPONSE_INVALID_VDEVID  0x1
2273
2274/* unsupported VDEV combination */
2275#define WMI_INIFIED_VDEV_START_RESPONSE_NOT_SUPPORTED   0x2
2276
2277/* Beacon processing related command and event structures */
2278struct wmi_bcn_tx_hdr {
2279        __le32 vdev_id;
2280        __le32 tx_rate;
2281        __le32 tx_power;
2282        __le32 bcn_len;
2283} __packed;
2284
2285struct wmi_bcn_tx_cmd {
2286        struct wmi_bcn_tx_hdr hdr;
2287        u8 *bcn[0];
2288} __packed;
2289
2290struct wmi_bcn_tx_arg {
2291        u32 vdev_id;
2292        u32 tx_rate;
2293        u32 tx_power;
2294        u32 bcn_len;
2295        const void *bcn;
2296};
2297
2298/* Beacon filter */
2299#define WMI_BCN_FILTER_ALL   0 /* Filter all beacons */
2300#define WMI_BCN_FILTER_NONE  1 /* Pass all beacons */
2301#define WMI_BCN_FILTER_RSSI  2 /* Pass Beacons RSSI >= RSSI threshold */
2302#define WMI_BCN_FILTER_BSSID 3 /* Pass Beacons with matching BSSID */
2303#define WMI_BCN_FILTER_SSID  4 /* Pass Beacons with matching SSID */
2304
2305struct wmi_bcn_filter_rx_cmd {
2306        /* Filter ID */
2307        __le32 bcn_filter_id;
2308        /* Filter type - wmi_bcn_filter */
2309        __le32 bcn_filter;
2310        /* Buffer len */
2311        __le32 bcn_filter_len;
2312        /* Filter info (threshold, BSSID, RSSI) */
2313        u8 *bcn_filter_buf;
2314} __packed;
2315
2316/* Capabilities and IEs to be passed to firmware */
2317struct wmi_bcn_prb_info {
2318        /* Capabilities */
2319        __le32 caps;
2320        /* ERP info */
2321        __le32 erp;
2322        /* Advanced capabilities */
2323        /* HT capabilities */
2324        /* HT Info */
2325        /* ibss_dfs */
2326        /* wpa Info */
2327        /* rsn Info */
2328        /* rrm info */
2329        /* ath_ext */
2330        /* app IE */
2331} __packed;
2332
2333struct wmi_bcn_tmpl_cmd {
2334        /* unique id identifying the VDEV, generated by the caller */
2335        __le32 vdev_id;
2336        /* TIM IE offset from the beginning of the template. */
2337        __le32 tim_ie_offset;
2338        /* beacon probe capabilities and IEs */
2339        struct wmi_bcn_prb_info bcn_prb_info;
2340        /* beacon buffer length */
2341        __le32 buf_len;
2342        /* variable length data */
2343        u8 data[1];
2344} __packed;
2345
2346struct wmi_prb_tmpl_cmd {
2347        /* unique id identifying the VDEV, generated by the caller */
2348        __le32 vdev_id;
2349        /* beacon probe capabilities and IEs */
2350        struct wmi_bcn_prb_info bcn_prb_info;
2351        /* beacon buffer length */
2352        __le32 buf_len;
2353        /* Variable length data */
2354        u8 data[1];
2355} __packed;
2356
2357enum wmi_sta_ps_mode {
2358        /* enable power save for the given STA VDEV */
2359        WMI_STA_PS_MODE_DISABLED = 0,
2360        /* disable power save  for a given STA VDEV */
2361        WMI_STA_PS_MODE_ENABLED = 1,
2362};
2363
2364struct wmi_sta_powersave_mode_cmd {
2365        /* unique id identifying the VDEV, generated by the caller */
2366        __le32 vdev_id;
2367
2368        /*
2369         * Power save mode
2370         * (see enum wmi_sta_ps_mode)
2371         */
2372        __le32 sta_ps_mode;
2373} __packed;
2374
2375enum wmi_csa_offload_en {
2376        WMI_CSA_OFFLOAD_DISABLE = 0,
2377        WMI_CSA_OFFLOAD_ENABLE = 1,
2378};
2379
2380struct wmi_csa_offload_enable_cmd {
2381        __le32 vdev_id;
2382        __le32 csa_offload_enable;
2383} __packed;
2384
2385struct wmi_csa_offload_chanswitch_cmd {
2386        __le32 vdev_id;
2387        struct wmi_channel chan;
2388} __packed;
2389
2390/*
2391 * This parameter controls the policy for retrieving frames from AP while the
2392 * STA is in sleep state.
2393 *
2394 * Only takes affect if the sta_ps_mode is enabled
2395 */
2396enum wmi_sta_ps_param_rx_wake_policy {
2397        /*
2398         * Wake up when ever there is an  RX activity on the VDEV. In this mode
2399         * the Power save SM(state machine) will come out of sleep by either
2400         * sending null frame (or) a data frame (with PS==0) in response to TIM
2401         * bit set in the received beacon frame from AP.
2402         */
2403        WMI_STA_PS_RX_WAKE_POLICY_WAKE = 0,
2404
2405        /*
2406         * Here the power save state machine will not wakeup in response to TIM
2407         * bit, instead it will send a PSPOLL (or) UASPD trigger based on UAPSD
2408         * configuration setup by WMISET_PS_SET_UAPSD  WMI command.  When all
2409         * access categories are delivery-enabled, the station will send a
2410         * UAPSD trigger frame, otherwise it will send a PS-Poll.
2411         */
2412        WMI_STA_PS_RX_WAKE_POLICY_POLL_UAPSD = 1,
2413};
2414
2415/*
2416 * Number of tx frames/beacon  that cause the power save SM to wake up.
2417 *
2418 * Value 1 causes the SM to wake up for every TX. Value 0 has a special
2419 * meaning, It will cause the SM to never wake up. This is useful if you want
2420 * to keep the system to sleep all the time for some kind of test mode . host
2421 * can change this parameter any time.  It will affect at the next tx frame.
2422 */
2423enum wmi_sta_ps_param_tx_wake_threshold {
2424        WMI_STA_PS_TX_WAKE_THRESHOLD_NEVER = 0,
2425        WMI_STA_PS_TX_WAKE_THRESHOLD_ALWAYS = 1,
2426
2427        /*
2428         * Values greater than one indicate that many TX attempts per beacon
2429         * interval before the STA will wake up
2430         */
2431};
2432
2433/*
2434 * The maximum number of PS-Poll frames the FW will send in response to
2435 * traffic advertised in TIM before waking up (by sending a null frame with PS
2436 * = 0). Value 0 has a special meaning: there is no maximum count and the FW
2437 * will send as many PS-Poll as are necessary to retrieve buffered BU. This
2438 * parameter is used when the RX wake policy is
2439 * WMI_STA_PS_RX_WAKE_POLICY_POLL_UAPSD and ignored when the RX wake
2440 * policy is WMI_STA_PS_RX_WAKE_POLICY_WAKE.
2441 */
2442enum wmi_sta_ps_param_pspoll_count {
2443        WMI_STA_PS_PSPOLL_COUNT_NO_MAX = 0,
2444        /*
2445         * Values greater than 0 indicate the maximum numer of PS-Poll frames
2446         * FW will send before waking up.
2447         */
2448};
2449
2450/*
2451 * This will include the delivery and trigger enabled state for every AC.
2452 * This is the negotiated state with AP. The host MLME needs to set this based
2453 * on AP capability and the state Set in the association request by the
2454 * station MLME.Lower 8 bits of the value specify the UAPSD configuration.
2455 */
2456#define WMI_UAPSD_AC_TYPE_DELI 0
2457#define WMI_UAPSD_AC_TYPE_TRIG 1
2458
2459#define WMI_UAPSD_AC_BIT_MASK(ac, type) \
2460        ((type ==  WMI_UAPSD_AC_TYPE_DELI) ? (1<<(ac<<1)) : (1<<((ac<<1)+1)))
2461
2462enum wmi_sta_ps_param_uapsd {
2463        WMI_STA_PS_UAPSD_AC0_DELIVERY_EN = (1 << 0),
2464        WMI_STA_PS_UAPSD_AC0_TRIGGER_EN  = (1 << 1),
2465        WMI_STA_PS_UAPSD_AC1_DELIVERY_EN = (1 << 2),
2466        WMI_STA_PS_UAPSD_AC1_TRIGGER_EN  = (1 << 3),
2467        WMI_STA_PS_UAPSD_AC2_DELIVERY_EN = (1 << 4),
2468        WMI_STA_PS_UAPSD_AC2_TRIGGER_EN  = (1 << 5),
2469        WMI_STA_PS_UAPSD_AC3_DELIVERY_EN = (1 << 6),
2470        WMI_STA_PS_UAPSD_AC3_TRIGGER_EN  = (1 << 7),
2471};
2472
2473enum wmi_sta_powersave_param {
2474        /*
2475         * Controls how frames are retrievd from AP while STA is sleeping
2476         *
2477         * (see enum wmi_sta_ps_param_rx_wake_policy)
2478         */
2479        WMI_STA_PS_PARAM_RX_WAKE_POLICY = 0,
2480
2481        /*
2482         * The STA will go active after this many TX
2483         *
2484         * (see enum wmi_sta_ps_param_tx_wake_threshold)
2485         */
2486        WMI_STA_PS_PARAM_TX_WAKE_THRESHOLD = 1,
2487
2488        /*
2489         * Number of PS-Poll to send before STA wakes up
2490         *
2491         * (see enum wmi_sta_ps_param_pspoll_count)
2492         *
2493         */
2494        WMI_STA_PS_PARAM_PSPOLL_COUNT = 2,
2495
2496        /*
2497         * TX/RX inactivity time in msec before going to sleep.
2498         *
2499         * The power save SM will monitor tx/rx activity on the VDEV, if no
2500         * activity for the specified msec of the parameter the Power save
2501         * SM will go to sleep.
2502         */
2503        WMI_STA_PS_PARAM_INACTIVITY_TIME = 3,
2504
2505        /*
2506         * Set uapsd configuration.
2507         *
2508         * (see enum wmi_sta_ps_param_uapsd)
2509         */
2510        WMI_STA_PS_PARAM_UAPSD = 4,
2511};
2512
2513struct wmi_sta_powersave_param_cmd {
2514        __le32 vdev_id;
2515        __le32 param_id; /* %WMI_STA_PS_PARAM_ */
2516        __le32 param_value;
2517} __packed;
2518
2519/* No MIMO power save */
2520#define WMI_STA_MIMO_PS_MODE_DISABLE
2521/* mimo powersave mode static*/
2522#define WMI_STA_MIMO_PS_MODE_STATIC
2523/* mimo powersave mode dynamic */
2524#define WMI_STA_MIMO_PS_MODE_DYNAMIC
2525
2526struct wmi_sta_mimo_ps_mode_cmd {
2527        /* unique id identifying the VDEV, generated by the caller */
2528        __le32 vdev_id;
2529        /* mimo powersave mode as defined above */
2530        __le32 mimo_pwrsave_mode;
2531} __packed;
2532
2533/* U-APSD configuration of peer station from (re)assoc request and TSPECs */
2534enum wmi_ap_ps_param_uapsd {
2535        WMI_AP_PS_UAPSD_AC0_DELIVERY_EN = (1 << 0),
2536        WMI_AP_PS_UAPSD_AC0_TRIGGER_EN  = (1 << 1),
2537        WMI_AP_PS_UAPSD_AC1_DELIVERY_EN = (1 << 2),
2538        WMI_AP_PS_UAPSD_AC1_TRIGGER_EN  = (1 << 3),
2539        WMI_AP_PS_UAPSD_AC2_DELIVERY_EN = (1 << 4),
2540        WMI_AP_PS_UAPSD_AC2_TRIGGER_EN  = (1 << 5),
2541        WMI_AP_PS_UAPSD_AC3_DELIVERY_EN = (1 << 6),
2542        WMI_AP_PS_UAPSD_AC3_TRIGGER_EN  = (1 << 7),
2543};
2544
2545/* U-APSD maximum service period of peer station */
2546enum wmi_ap_ps_peer_param_max_sp {
2547        WMI_AP_PS_PEER_PARAM_MAX_SP_UNLIMITED = 0,
2548        WMI_AP_PS_PEER_PARAM_MAX_SP_2 = 1,
2549        WMI_AP_PS_PEER_PARAM_MAX_SP_4 = 2,
2550        WMI_AP_PS_PEER_PARAM_MAX_SP_6 = 3,
2551        MAX_WMI_AP_PS_PEER_PARAM_MAX_SP,
2552};
2553
2554/*
2555 * AP power save parameter
2556 * Set a power save specific parameter for a peer station
2557 */
2558enum wmi_ap_ps_peer_param {
2559        /* Set uapsd configuration for a given peer.
2560         *
2561         * Include the delivery and trigger enabled state for every AC.
2562         * The host  MLME needs to set this based on AP capability and stations
2563         * request Set in the association request  received from the station.
2564         *
2565         * Lower 8 bits of the value specify the UAPSD configuration.
2566         *
2567         * (see enum wmi_ap_ps_param_uapsd)
2568         * The default value is 0.
2569         */
2570        WMI_AP_PS_PEER_PARAM_UAPSD = 0,
2571
2572        /*
2573         * Set the service period for a UAPSD capable station
2574         *
2575         * The service period from wme ie in the (re)assoc request frame.
2576         *
2577         * (see enum wmi_ap_ps_peer_param_max_sp)
2578         */
2579        WMI_AP_PS_PEER_PARAM_MAX_SP = 1,
2580
2581        /* Time in seconds for aging out buffered frames for STA in PS */
2582        WMI_AP_PS_PEER_PARAM_AGEOUT_TIME = 2,
2583};
2584
2585struct wmi_ap_ps_peer_cmd {
2586        /* unique id identifying the VDEV, generated by the caller */
2587        __le32 vdev_id;
2588
2589        /* peer MAC address */
2590        struct wmi_mac_addr peer_macaddr;
2591
2592        /* AP powersave param (see enum wmi_ap_ps_peer_param) */
2593        __le32 param_id;
2594
2595        /* AP powersave param value */
2596        __le32 param_value;
2597} __packed;
2598
2599/* 128 clients = 4 words */
2600#define WMI_TIM_BITMAP_ARRAY_SIZE 4
2601
2602struct wmi_tim_info {
2603        __le32 tim_len;
2604        __le32 tim_mcast;
2605        __le32 tim_bitmap[WMI_TIM_BITMAP_ARRAY_SIZE];
2606        __le32 tim_changed;
2607        __le32 tim_num_ps_pending;
2608} __packed;
2609
2610/* Maximum number of NOA Descriptors supported */
2611#define WMI_P2P_MAX_NOA_DESCRIPTORS 4
2612#define WMI_P2P_OPPPS_ENABLE_BIT        BIT(0)
2613#define WMI_P2P_OPPPS_CTWINDOW_OFFSET   1
2614#define WMI_P2P_NOA_CHANGED_BIT BIT(0)
2615
2616struct wmi_p2p_noa_info {
2617        /* Bit 0 - Flag to indicate an update in NOA schedule
2618           Bits 7-1 - Reserved */
2619        u8 changed;
2620        /* NOA index */
2621        u8 index;
2622        /* Bit 0 - Opp PS state of the AP
2623           Bits 1-7 - Ctwindow in TUs */
2624        u8 ctwindow_oppps;
2625        /* Number of NOA descriptors */
2626        u8 num_descriptors;
2627
2628        struct wmi_p2p_noa_descriptor descriptors[WMI_P2P_MAX_NOA_DESCRIPTORS];
2629} __packed;
2630
2631struct wmi_bcn_info {
2632        struct wmi_tim_info tim_info;
2633        struct wmi_p2p_noa_info p2p_noa_info;
2634} __packed;
2635
2636struct wmi_host_swba_event {
2637        __le32 vdev_map;
2638        struct wmi_bcn_info bcn_info[1];
2639} __packed;
2640
2641#define WMI_MAX_AP_VDEV 16
2642
2643struct wmi_tbtt_offset_event {
2644        __le32 vdev_map;
2645        __le32 tbttoffset_list[WMI_MAX_AP_VDEV];
2646} __packed;
2647
2648
2649struct wmi_peer_create_cmd {
2650        __le32 vdev_id;
2651        struct wmi_mac_addr peer_macaddr;
2652} __packed;
2653
2654struct wmi_peer_delete_cmd {
2655        __le32 vdev_id;
2656        struct wmi_mac_addr peer_macaddr;
2657} __packed;
2658
2659struct wmi_peer_flush_tids_cmd {
2660        __le32 vdev_id;
2661        struct wmi_mac_addr peer_macaddr;
2662        __le32 peer_tid_bitmap;
2663} __packed;
2664
2665struct wmi_fixed_rate {
2666        /*
2667         * rate mode . 0: disable fixed rate (auto rate)
2668         *   1: legacy (non 11n) rate  specified as ieee rate 2*Mbps
2669         *   2: ht20 11n rate  specified as mcs index
2670         *   3: ht40 11n rate  specified as mcs index
2671         */
2672        __le32  rate_mode;
2673        /*
2674         * 4 rate values for 4 rate series. series 0 is stored in byte 0 (LSB)
2675         * and series 3 is stored at byte 3 (MSB)
2676         */
2677        __le32  rate_series;
2678        /*
2679         * 4 retry counts for 4 rate series. retry count for rate 0 is stored
2680         * in byte 0 (LSB) and retry count for rate 3 is stored at byte 3
2681         * (MSB)
2682         */
2683        __le32  rate_retries;
2684} __packed;
2685
2686struct wmi_peer_fixed_rate_cmd {
2687        /* unique id identifying the VDEV, generated by the caller */
2688        __le32 vdev_id;
2689        /* peer MAC address */
2690        struct wmi_mac_addr peer_macaddr;
2691        /* fixed rate */
2692        struct wmi_fixed_rate peer_fixed_rate;
2693} __packed;
2694
2695#define WMI_MGMT_TID    17
2696
2697struct wmi_addba_clear_resp_cmd {
2698        /* unique id identifying the VDEV, generated by the caller */
2699        __le32 vdev_id;
2700        /* peer MAC address */
2701        struct wmi_mac_addr peer_macaddr;
2702} __packed;
2703
2704struct wmi_addba_send_cmd {
2705        /* unique id identifying the VDEV, generated by the caller */
2706        __le32 vdev_id;
2707        /* peer MAC address */
2708        struct wmi_mac_addr peer_macaddr;
2709        /* Tid number */
2710        __le32 tid;
2711        /* Buffer/Window size*/
2712        __le32 buffersize;
2713} __packed;
2714
2715struct wmi_delba_send_cmd {
2716        /* unique id identifying the VDEV, generated by the caller */
2717        __le32 vdev_id;
2718        /* peer MAC address */
2719        struct wmi_mac_addr peer_macaddr;
2720        /* Tid number */
2721        __le32 tid;
2722        /* Is Initiator */
2723        __le32 initiator;
2724        /* Reason code */
2725        __le32 reasoncode;
2726} __packed;
2727
2728struct wmi_addba_setresponse_cmd {
2729        /* unique id identifying the vdev, generated by the caller */
2730        __le32 vdev_id;
2731        /* peer mac address */
2732        struct wmi_mac_addr peer_macaddr;
2733        /* Tid number */
2734        __le32 tid;
2735        /* status code */
2736        __le32 statuscode;
2737} __packed;
2738
2739struct wmi_send_singleamsdu_cmd {
2740        /* unique id identifying the vdev, generated by the caller */
2741        __le32 vdev_id;
2742        /* peer mac address */
2743        struct wmi_mac_addr peer_macaddr;
2744        /* Tid number */
2745        __le32 tid;
2746} __packed;
2747
2748enum wmi_peer_smps_state {
2749        WMI_PEER_SMPS_PS_NONE = 0x0,
2750        WMI_PEER_SMPS_STATIC  = 0x1,
2751        WMI_PEER_SMPS_DYNAMIC = 0x2
2752};
2753
2754enum wmi_peer_param {
2755        WMI_PEER_SMPS_STATE = 0x1, /* see %wmi_peer_smps_state */
2756        WMI_PEER_AMPDU      = 0x2,
2757        WMI_PEER_AUTHORIZE  = 0x3,
2758        WMI_PEER_CHAN_WIDTH = 0x4,
2759        WMI_PEER_NSS        = 0x5,
2760        WMI_PEER_USE_4ADDR  = 0x6
2761};
2762
2763struct wmi_peer_set_param_cmd {
2764        __le32 vdev_id;
2765        struct wmi_mac_addr peer_macaddr;
2766        __le32 param_id;
2767        __le32 param_value;
2768} __packed;
2769
2770#define MAX_SUPPORTED_RATES 128
2771
2772struct wmi_rate_set {
2773        /* total number of rates */
2774        __le32 num_rates;
2775        /*
2776         * rates (each 8bit value) packed into a 32 bit word.
2777         * the rates are filled from least significant byte to most
2778         * significant byte.
2779         */
2780        __le32 rates[(MAX_SUPPORTED_RATES/4)+1];
2781} __packed;
2782
2783struct wmi_rate_set_arg {
2784        unsigned int num_rates;
2785        u8 rates[MAX_SUPPORTED_RATES];
2786};
2787
2788/*
2789 * NOTE: It would bea good idea to represent the Tx MCS
2790 * info in one word and Rx in another word. This is split
2791 * into multiple words for convenience
2792 */
2793struct wmi_vht_rate_set {
2794        __le32 rx_max_rate; /* Max Rx data rate */
2795        __le32 rx_mcs_set;  /* Negotiated RX VHT rates */
2796        __le32 tx_max_rate; /* Max Tx data rate */
2797        __le32 tx_mcs_set;  /* Negotiated TX VHT rates */
2798} __packed;
2799
2800struct wmi_vht_rate_set_arg {
2801        u32 rx_max_rate;
2802        u32 rx_mcs_set;
2803        u32 tx_max_rate;
2804        u32 tx_mcs_set;
2805};
2806
2807struct wmi_peer_set_rates_cmd {
2808        /* peer MAC address */
2809        struct wmi_mac_addr peer_macaddr;
2810        /* legacy rate set */
2811        struct wmi_rate_set peer_legacy_rates;
2812        /* ht rate set */
2813        struct wmi_rate_set peer_ht_rates;
2814} __packed;
2815
2816struct wmi_peer_set_q_empty_callback_cmd {
2817        /* unique id identifying the VDEV, generated by the caller */
2818        __le32 vdev_id;
2819        /* peer MAC address */
2820        struct wmi_mac_addr peer_macaddr;
2821        __le32 callback_enable;
2822} __packed;
2823
2824#define WMI_PEER_AUTH           0x00000001
2825#define WMI_PEER_QOS            0x00000002
2826#define WMI_PEER_NEED_PTK_4_WAY 0x00000004
2827#define WMI_PEER_NEED_GTK_2_WAY 0x00000010
2828#define WMI_PEER_APSD           0x00000800
2829#define WMI_PEER_HT             0x00001000
2830#define WMI_PEER_40MHZ          0x00002000
2831#define WMI_PEER_STBC           0x00008000
2832#define WMI_PEER_LDPC           0x00010000
2833#define WMI_PEER_DYN_MIMOPS     0x00020000
2834#define WMI_PEER_STATIC_MIMOPS  0x00040000
2835#define WMI_PEER_SPATIAL_MUX    0x00200000
2836#define WMI_PEER_VHT            0x02000000
2837#define WMI_PEER_80MHZ          0x04000000
2838#define WMI_PEER_PMF            0x08000000
2839
2840/*
2841 * Peer rate capabilities.
2842 *
2843 * This is of interest to the ratecontrol
2844 * module which resides in the firmware. The bit definitions are
2845 * consistent with that defined in if_athrate.c.
2846 */
2847#define WMI_RC_DS_FLAG          0x01
2848#define WMI_RC_CW40_FLAG        0x02
2849#define WMI_RC_SGI_FLAG         0x04
2850#define WMI_RC_HT_FLAG          0x08
2851#define WMI_RC_RTSCTS_FLAG      0x10
2852#define WMI_RC_TX_STBC_FLAG     0x20
2853#define WMI_RC_RX_STBC_FLAG     0xC0
2854#define WMI_RC_RX_STBC_FLAG_S   6
2855#define WMI_RC_WEP_TKIP_FLAG    0x100
2856#define WMI_RC_TS_FLAG          0x200
2857#define WMI_RC_UAPSD_FLAG       0x400
2858
2859/* Maximum listen interval supported by hw in units of beacon interval */
2860#define ATH10K_MAX_HW_LISTEN_INTERVAL 5
2861
2862struct wmi_peer_assoc_complete_cmd {
2863        struct wmi_mac_addr peer_macaddr;
2864        __le32 vdev_id;
2865        __le32 peer_new_assoc; /* 1=assoc, 0=reassoc */
2866        __le32 peer_associd; /* 16 LSBs */
2867        __le32 peer_flags;
2868        __le32 peer_caps; /* 16 LSBs */
2869        __le32 peer_listen_intval;
2870        __le32 peer_ht_caps;
2871        __le32 peer_max_mpdu;
2872        __le32 peer_mpdu_density; /* 0..16 */
2873        __le32 peer_rate_caps;
2874        struct wmi_rate_set peer_legacy_rates;
2875        struct wmi_rate_set peer_ht_rates;
2876        __le32 peer_nss; /* num of spatial streams */
2877        __le32 peer_vht_caps;
2878        __le32 peer_phymode;
2879        struct wmi_vht_rate_set peer_vht_rates;
2880        /* HT Operation Element of the peer. Five bytes packed in 2
2881         *  INT32 array and filled from lsb to msb. */
2882        __le32 peer_ht_info[2];
2883} __packed;
2884
2885struct wmi_peer_assoc_complete_arg {
2886        u8 addr[ETH_ALEN];
2887        u32 vdev_id;
2888        bool peer_reassoc;
2889        u16 peer_aid;
2890        u32 peer_flags; /* see %WMI_PEER_ */
2891        u16 peer_caps;
2892        u32 peer_listen_intval;
2893        u32 peer_ht_caps;
2894        u32 peer_max_mpdu;
2895        u32 peer_mpdu_density; /* 0..16 */
2896        u32 peer_rate_caps; /* see %WMI_RC_ */
2897        struct wmi_rate_set_arg peer_legacy_rates;
2898        struct wmi_rate_set_arg peer_ht_rates;
2899        u32 peer_num_spatial_streams;
2900        u32 peer_vht_caps;
2901        enum wmi_phy_mode peer_phymode;
2902        struct wmi_vht_rate_set_arg peer_vht_rates;
2903};
2904
2905struct wmi_peer_add_wds_entry_cmd {
2906        /* peer MAC address */
2907        struct wmi_mac_addr peer_macaddr;
2908        /* wds MAC addr */
2909        struct wmi_mac_addr wds_macaddr;
2910} __packed;
2911
2912struct wmi_peer_remove_wds_entry_cmd {
2913        /* wds MAC addr */
2914        struct wmi_mac_addr wds_macaddr;
2915} __packed;
2916
2917struct wmi_peer_q_empty_callback_event {
2918        /* peer MAC address */
2919        struct wmi_mac_addr peer_macaddr;
2920} __packed;
2921
2922/*
2923 * Channel info WMI event
2924 */
2925struct wmi_chan_info_event {
2926        __le32 err_code;
2927        __le32 freq;
2928        __le32 cmd_flags;
2929        __le32 noise_floor;
2930        __le32 rx_clear_count;
2931        __le32 cycle_count;
2932} __packed;
2933
2934#define WMI_CHAN_INFO_FLAG_COMPLETE BIT(0)
2935
2936/* FIXME: empirically extrapolated */
2937#define WMI_CHAN_INFO_MSEC(x) ((x) / 76595)
2938
2939/* Beacon filter wmi command info */
2940#define BCN_FLT_MAX_SUPPORTED_IES       256
2941#define BCN_FLT_MAX_ELEMS_IE_LIST       (BCN_FLT_MAX_SUPPORTED_IES / 32)
2942
2943struct bss_bcn_stats {
2944        __le32 vdev_id;
2945        __le32 bss_bcnsdropped;
2946        __le32 bss_bcnsdelivered;
2947} __packed;
2948
2949struct bcn_filter_stats {
2950        __le32 bcns_dropped;
2951        __le32 bcns_delivered;
2952        __le32 activefilters;
2953        struct bss_bcn_stats bss_stats;
2954} __packed;
2955
2956struct wmi_add_bcn_filter_cmd {
2957        u32 vdev_id;
2958        u32 ie_map[BCN_FLT_MAX_ELEMS_IE_LIST];
2959} __packed;
2960
2961enum wmi_sta_keepalive_method {
2962        WMI_STA_KEEPALIVE_METHOD_NULL_FRAME = 1,
2963        WMI_STA_KEEPALIVE_METHOD_UNSOLICITATED_ARP_RESPONSE = 2,
2964};
2965
2966/* note: ip4 addresses are in network byte order, i.e. big endian */
2967struct wmi_sta_keepalive_arp_resp {
2968        __be32 src_ip4_addr;
2969        __be32 dest_ip4_addr;
2970        struct wmi_mac_addr dest_mac_addr;
2971} __packed;
2972
2973struct wmi_sta_keepalive_cmd {
2974        __le32 vdev_id;
2975        __le32 enabled;
2976        __le32 method; /* WMI_STA_KEEPALIVE_METHOD_ */
2977        __le32 interval; /* in seconds */
2978        struct wmi_sta_keepalive_arp_resp arp_resp;
2979} __packed;
2980
2981enum wmi_force_fw_hang_type {
2982        WMI_FORCE_FW_HANG_ASSERT = 1,
2983        WMI_FORCE_FW_HANG_NO_DETECT,
2984        WMI_FORCE_FW_HANG_CTRL_EP_FULL,
2985        WMI_FORCE_FW_HANG_EMPTY_POINT,
2986        WMI_FORCE_FW_HANG_STACK_OVERFLOW,
2987        WMI_FORCE_FW_HANG_INFINITE_LOOP,
2988};
2989
2990#define WMI_FORCE_FW_HANG_RANDOM_TIME 0xFFFFFFFF
2991
2992struct wmi_force_fw_hang_cmd {
2993        __le32 type;
2994        __le32 delay_ms;
2995} __packed;
2996
2997#define ATH10K_RTS_MAX          2347
2998#define ATH10K_FRAGMT_THRESHOLD_MIN     540
2999#define ATH10K_FRAGMT_THRESHOLD_MAX     2346
3000
3001#define WMI_MAX_EVENT 0x1000
3002/* Maximum number of pending TXed WMI packets */
3003#define WMI_MAX_PENDING_TX_COUNT 128
3004#define WMI_SKB_HEADROOM sizeof(struct wmi_cmd_hdr)
3005
3006/* By default disable power save for IBSS */
3007#define ATH10K_DEFAULT_ATIM 0
3008
3009struct ath10k;
3010struct ath10k_vif;
3011
3012int ath10k_wmi_attach(struct ath10k *ar);
3013void ath10k_wmi_detach(struct ath10k *ar);
3014int ath10k_wmi_wait_for_service_ready(struct ath10k *ar);
3015int ath10k_wmi_wait_for_unified_ready(struct ath10k *ar);
3016void ath10k_wmi_flush_tx(struct ath10k *ar);
3017
3018int ath10k_wmi_connect_htc_service(struct ath10k *ar);
3019int ath10k_wmi_pdev_set_channel(struct ath10k *ar,
3020                                const struct wmi_channel_arg *);
3021int ath10k_wmi_pdev_suspend_target(struct ath10k *ar);
3022int ath10k_wmi_pdev_resume_target(struct ath10k *ar);
3023int ath10k_wmi_pdev_set_regdomain(struct ath10k *ar, u16 rd, u16 rd2g,
3024                                  u16 rd5g, u16 ctl2g, u16 ctl5g);
3025int ath10k_wmi_pdev_set_param(struct ath10k *ar, enum wmi_pdev_param id,
3026                              u32 value);
3027int ath10k_wmi_cmd_init(struct ath10k *ar);
3028int ath10k_wmi_start_scan(struct ath10k *ar, const struct wmi_start_scan_arg *);
3029void ath10k_wmi_start_scan_init(struct ath10k *ar, struct wmi_start_scan_arg *);
3030int ath10k_wmi_stop_scan(struct ath10k *ar,
3031                         const struct wmi_stop_scan_arg *arg);
3032int ath10k_wmi_vdev_create(struct ath10k *ar, u32 vdev_id,
3033                           enum wmi_vdev_type type,
3034                           enum wmi_vdev_subtype subtype,
3035                           const u8 macaddr[ETH_ALEN]);
3036int ath10k_wmi_vdev_delete(struct ath10k *ar, u32 vdev_id);
3037int ath10k_wmi_vdev_start(struct ath10k *ar,
3038                          const struct wmi_vdev_start_request_arg *);
3039int ath10k_wmi_vdev_restart(struct ath10k *ar,
3040                            const struct wmi_vdev_start_request_arg *);
3041int ath10k_wmi_vdev_stop(struct ath10k *ar, u32 vdev_id);
3042int ath10k_wmi_vdev_up(struct ath10k *ar, u32 vdev_id, u32 aid,
3043                       const u8 *bssid);
3044int ath10k_wmi_vdev_down(struct ath10k *ar, u32 vdev_id);
3045int ath10k_wmi_vdev_set_param(struct ath10k *ar, u32 vdev_id,
3046                              enum wmi_vdev_param param_id, u32 param_value);
3047int ath10k_wmi_vdev_install_key(struct ath10k *ar,
3048                                const struct wmi_vdev_install_key_arg *arg);
3049int ath10k_wmi_peer_create(struct ath10k *ar, u32 vdev_id,
3050                    const u8 peer_addr[ETH_ALEN]);
3051int ath10k_wmi_peer_delete(struct ath10k *ar, u32 vdev_id,
3052                    const u8 peer_addr[ETH_ALEN]);
3053int ath10k_wmi_peer_flush(struct ath10k *ar, u32 vdev_id,
3054                   const u8 peer_addr[ETH_ALEN], u32 tid_bitmap);
3055int ath10k_wmi_peer_set_param(struct ath10k *ar, u32 vdev_id,
3056                              const u8 *peer_addr,
3057                              enum wmi_peer_param param_id, u32 param_value);
3058int ath10k_wmi_peer_assoc(struct ath10k *ar,
3059                          const struct wmi_peer_assoc_complete_arg *arg);
3060int ath10k_wmi_set_psmode(struct ath10k *ar, u32 vdev_id,
3061                          enum wmi_sta_ps_mode psmode);
3062int ath10k_wmi_set_sta_ps_param(struct ath10k *ar, u32 vdev_id,
3063                                enum wmi_sta_powersave_param param_id,
3064                                u32 value);
3065int ath10k_wmi_set_ap_ps_param(struct ath10k *ar, u32 vdev_id, const u8 *mac,
3066                               enum wmi_ap_ps_peer_param param_id, u32 value);
3067int ath10k_wmi_scan_chan_list(struct ath10k *ar,
3068                              const struct wmi_scan_chan_list_arg *arg);
3069int ath10k_wmi_beacon_send(struct ath10k *ar, const struct wmi_bcn_tx_arg *arg);
3070int ath10k_wmi_pdev_set_wmm_params(struct ath10k *ar,
3071                        const struct wmi_pdev_set_wmm_params_arg *arg);
3072int ath10k_wmi_request_stats(struct ath10k *ar, enum wmi_stats_id stats_id);
3073int ath10k_wmi_force_fw_hang(struct ath10k *ar,
3074                             enum wmi_force_fw_hang_type type, u32 delay_ms);
3075
3076#endif /* _WMI_H_ */
3077