2 * Copyright (c) 2005-2011 Atheros Communications Inc.
3 * Copyright (c) 2011-2013 Qualcomm Atheros, Inc.
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.
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.
21 #include <linux/types.h>
22 #include <net/mac80211.h>
25 * This file specifies the WMI interface for the Unified Software
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.
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.
36 * Guidelines for extending this interface are below.
38 * 1. Add new WMI commands ONLY within the specified range - 0x9000 - 0x9fff
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.
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
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.
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
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.
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
73 #define HTC_PROTOCOL_VERSION 0x0002
74 #define WMI_PROTOCOL_VERSION 0x0002
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 */
111 WMI_MAX_SERVICE = 64 /* max service */
114 static inline char *wmi_service_name(int service_id)
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:
131 case WMI_SERVICE_AP_DFS:
133 case WMI_SERVICE_11AC:
135 case WMI_SERVICE_BLOCKACK:
137 case WMI_SERVICE_PHYERR:
139 case WMI_SERVICE_BCN_FILTER:
141 case WMI_SERVICE_RTT:
143 case WMI_SERVICE_RATECTRL:
145 case WMI_SERVICE_WOW:
147 case WMI_SERVICE_RATECTRL_CACHE:
148 return "RATECTRL CACHE";
149 case WMI_SERVICE_IRAM_TIDS:
151 case WMI_SERVICE_ARPNS_OFFLOAD:
152 return "ARPNS_OFFLOAD";
153 case WMI_SERVICE_NLO:
155 case WMI_SERVICE_GTK_OFFLOAD:
156 return "GTK_OFFLOAD";
157 case WMI_SERVICE_SCAN_SCH:
159 case WMI_SERVICE_CSA_OFFLOAD:
160 return "CSA_OFFLOAD";
161 case WMI_SERVICE_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:
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:
177 case WMI_SERVICE_STA_KEEP_ALIVE:
178 return "STA KEEP ALIVE";
179 case WMI_SERVICE_TX_ENCAP:
182 return "UNKNOWN SERVICE\n";
187 #define WMI_SERVICE_BM_SIZE \
188 ((WMI_MAX_SERVICE + sizeof(u32) - 1)/sizeof(u32))
190 /* 2 word representation of MAC addr */
191 struct wmi_mac_addr {
203 u32 start_scan_cmdid;
205 u32 scan_chan_list_cmdid;
206 u32 scan_sch_prio_tbl_cmdid;
207 u32 pdev_set_regdomain_cmdid;
208 u32 pdev_set_channel_cmdid;
209 u32 pdev_set_param_cmdid;
210 u32 pdev_pktlog_enable_cmdid;
211 u32 pdev_pktlog_disable_cmdid;
212 u32 pdev_set_wmm_params_cmdid;
213 u32 pdev_set_ht_cap_ie_cmdid;
214 u32 pdev_set_vht_cap_ie_cmdid;
215 u32 pdev_set_dscp_tid_map_cmdid;
216 u32 pdev_set_quiet_mode_cmdid;
217 u32 pdev_green_ap_ps_enable_cmdid;
218 u32 pdev_get_tpc_config_cmdid;
219 u32 pdev_set_base_macaddr_cmdid;
220 u32 vdev_create_cmdid;
221 u32 vdev_delete_cmdid;
222 u32 vdev_start_request_cmdid;
223 u32 vdev_restart_request_cmdid;
227 u32 vdev_set_param_cmdid;
228 u32 vdev_install_key_cmdid;
229 u32 peer_create_cmdid;
230 u32 peer_delete_cmdid;
231 u32 peer_flush_tids_cmdid;
232 u32 peer_set_param_cmdid;
233 u32 peer_assoc_cmdid;
234 u32 peer_add_wds_entry_cmdid;
235 u32 peer_remove_wds_entry_cmdid;
236 u32 peer_mcast_group_cmdid;
238 u32 pdev_send_bcn_cmdid;
240 u32 bcn_filter_rx_cmdid;
241 u32 prb_req_filter_rx_cmdid;
244 u32 addba_clear_resp_cmdid;
245 u32 addba_send_cmdid;
246 u32 addba_status_cmdid;
247 u32 delba_send_cmdid;
248 u32 addba_set_resp_cmdid;
249 u32 send_singleamsdu_cmdid;
250 u32 sta_powersave_mode_cmdid;
251 u32 sta_powersave_param_cmdid;
252 u32 sta_mimo_ps_mode_cmdid;
253 u32 pdev_dfs_enable_cmdid;
254 u32 pdev_dfs_disable_cmdid;
256 u32 roam_scan_rssi_threshold;
257 u32 roam_scan_period;
258 u32 roam_scan_rssi_change_threshold;
260 u32 ofl_scan_add_ap_profile;
261 u32 ofl_scan_remove_ap_profile;
263 u32 p2p_dev_set_device_info;
264 u32 p2p_dev_set_discoverability;
265 u32 p2p_go_set_beacon_ie;
266 u32 p2p_go_set_probe_resp_ie;
267 u32 p2p_set_vendor_ie_data_cmdid;
268 u32 ap_ps_peer_param_cmdid;
269 u32 ap_ps_peer_uapsd_coex_cmdid;
270 u32 peer_rate_retry_sched_cmdid;
271 u32 wlan_profile_trigger_cmdid;
272 u32 wlan_profile_set_hist_intvl_cmdid;
273 u32 wlan_profile_get_profile_data_cmdid;
274 u32 wlan_profile_enable_profile_id_cmdid;
275 u32 wlan_profile_list_profile_id_cmdid;
276 u32 pdev_suspend_cmdid;
277 u32 pdev_resume_cmdid;
278 u32 add_bcn_filter_cmdid;
279 u32 rmv_bcn_filter_cmdid;
280 u32 wow_add_wake_pattern_cmdid;
281 u32 wow_del_wake_pattern_cmdid;
282 u32 wow_enable_disable_wake_event_cmdid;
283 u32 wow_enable_cmdid;
284 u32 wow_hostwakeup_from_sleep_cmdid;
285 u32 rtt_measreq_cmdid;
287 u32 vdev_spectral_scan_configure_cmdid;
288 u32 vdev_spectral_scan_enable_cmdid;
289 u32 request_stats_cmdid;
290 u32 set_arp_ns_offload_cmdid;
291 u32 network_list_offload_config_cmdid;
292 u32 gtk_offload_cmdid;
293 u32 csa_offload_enable_cmdid;
294 u32 csa_offload_chanswitch_cmdid;
295 u32 chatter_set_mode_cmdid;
296 u32 peer_tid_addba_cmdid;
297 u32 peer_tid_delba_cmdid;
298 u32 sta_dtim_ps_method_cmdid;
299 u32 sta_uapsd_auto_trig_cmdid;
300 u32 sta_keepalive_cmd;
303 u32 dbglog_cfg_cmdid;
305 u32 pdev_ftm_intg_cmdid;
306 u32 vdev_set_keepalive_cmdid;
307 u32 vdev_get_keepalive_cmdid;
308 u32 force_fw_hang_cmdid;
309 u32 gpio_config_cmdid;
310 u32 gpio_output_cmdid;
314 * wmi command groups.
317 /* 0 to 2 are reserved */
319 WMI_GRP_SCAN = WMI_GRP_START,
349 #define WMI_CMD_GRP(grp_id) (((grp_id) << 12) | 0x1)
350 #define WMI_EVT_GRP_START_ID(grp_id) (((grp_id) << 12) | 0x1)
352 #define WMI_CMD_UNSUPPORTED 0
354 /* Command IDs and command events for MAIN FW. */
356 WMI_INIT_CMDID = 0x1,
358 /* Scan specific commands */
359 WMI_START_SCAN_CMDID = WMI_CMD_GRP(WMI_GRP_SCAN),
361 WMI_SCAN_CHAN_LIST_CMDID,
362 WMI_SCAN_SCH_PRIO_TBL_CMDID,
364 /* PDEV (physical device) specific commands */
365 WMI_PDEV_SET_REGDOMAIN_CMDID = WMI_CMD_GRP(WMI_GRP_PDEV),
366 WMI_PDEV_SET_CHANNEL_CMDID,
367 WMI_PDEV_SET_PARAM_CMDID,
368 WMI_PDEV_PKTLOG_ENABLE_CMDID,
369 WMI_PDEV_PKTLOG_DISABLE_CMDID,
370 WMI_PDEV_SET_WMM_PARAMS_CMDID,
371 WMI_PDEV_SET_HT_CAP_IE_CMDID,
372 WMI_PDEV_SET_VHT_CAP_IE_CMDID,
373 WMI_PDEV_SET_DSCP_TID_MAP_CMDID,
374 WMI_PDEV_SET_QUIET_MODE_CMDID,
375 WMI_PDEV_GREEN_AP_PS_ENABLE_CMDID,
376 WMI_PDEV_GET_TPC_CONFIG_CMDID,
377 WMI_PDEV_SET_BASE_MACADDR_CMDID,
379 /* VDEV (virtual device) specific commands */
380 WMI_VDEV_CREATE_CMDID = WMI_CMD_GRP(WMI_GRP_VDEV),
381 WMI_VDEV_DELETE_CMDID,
382 WMI_VDEV_START_REQUEST_CMDID,
383 WMI_VDEV_RESTART_REQUEST_CMDID,
387 WMI_VDEV_SET_PARAM_CMDID,
388 WMI_VDEV_INSTALL_KEY_CMDID,
390 /* peer specific commands */
391 WMI_PEER_CREATE_CMDID = WMI_CMD_GRP(WMI_GRP_PEER),
392 WMI_PEER_DELETE_CMDID,
393 WMI_PEER_FLUSH_TIDS_CMDID,
394 WMI_PEER_SET_PARAM_CMDID,
395 WMI_PEER_ASSOC_CMDID,
396 WMI_PEER_ADD_WDS_ENTRY_CMDID,
397 WMI_PEER_REMOVE_WDS_ENTRY_CMDID,
398 WMI_PEER_MCAST_GROUP_CMDID,
400 /* beacon/management specific commands */
401 WMI_BCN_TX_CMDID = WMI_CMD_GRP(WMI_GRP_MGMT),
402 WMI_PDEV_SEND_BCN_CMDID,
404 WMI_BCN_FILTER_RX_CMDID,
405 WMI_PRB_REQ_FILTER_RX_CMDID,
409 /* commands to directly control BA negotiation directly from host. */
410 WMI_ADDBA_CLEAR_RESP_CMDID = WMI_CMD_GRP(WMI_GRP_BA_NEG),
411 WMI_ADDBA_SEND_CMDID,
412 WMI_ADDBA_STATUS_CMDID,
413 WMI_DELBA_SEND_CMDID,
414 WMI_ADDBA_SET_RESP_CMDID,
415 WMI_SEND_SINGLEAMSDU_CMDID,
417 /* Station power save specific config */
418 WMI_STA_POWERSAVE_MODE_CMDID = WMI_CMD_GRP(WMI_GRP_STA_PS),
419 WMI_STA_POWERSAVE_PARAM_CMDID,
420 WMI_STA_MIMO_PS_MODE_CMDID,
422 /** DFS-specific commands */
423 WMI_PDEV_DFS_ENABLE_CMDID = WMI_CMD_GRP(WMI_GRP_DFS),
424 WMI_PDEV_DFS_DISABLE_CMDID,
426 /* Roaming specific commands */
427 WMI_ROAM_SCAN_MODE = WMI_CMD_GRP(WMI_GRP_ROAM),
428 WMI_ROAM_SCAN_RSSI_THRESHOLD,
429 WMI_ROAM_SCAN_PERIOD,
430 WMI_ROAM_SCAN_RSSI_CHANGE_THRESHOLD,
433 /* offload scan specific commands */
434 WMI_OFL_SCAN_ADD_AP_PROFILE = WMI_CMD_GRP(WMI_GRP_OFL_SCAN),
435 WMI_OFL_SCAN_REMOVE_AP_PROFILE,
438 /* P2P specific commands */
439 WMI_P2P_DEV_SET_DEVICE_INFO = WMI_CMD_GRP(WMI_GRP_P2P),
440 WMI_P2P_DEV_SET_DISCOVERABILITY,
441 WMI_P2P_GO_SET_BEACON_IE,
442 WMI_P2P_GO_SET_PROBE_RESP_IE,
443 WMI_P2P_SET_VENDOR_IE_DATA_CMDID,
445 /* AP power save specific config */
446 WMI_AP_PS_PEER_PARAM_CMDID = WMI_CMD_GRP(WMI_GRP_AP_PS),
447 WMI_AP_PS_PEER_UAPSD_COEX_CMDID,
449 /* Rate-control specific commands */
450 WMI_PEER_RATE_RETRY_SCHED_CMDID =
451 WMI_CMD_GRP(WMI_GRP_RATE_CTRL),
453 /* WLAN Profiling commands. */
454 WMI_WLAN_PROFILE_TRIGGER_CMDID = WMI_CMD_GRP(WMI_GRP_PROFILE),
455 WMI_WLAN_PROFILE_SET_HIST_INTVL_CMDID,
456 WMI_WLAN_PROFILE_GET_PROFILE_DATA_CMDID,
457 WMI_WLAN_PROFILE_ENABLE_PROFILE_ID_CMDID,
458 WMI_WLAN_PROFILE_LIST_PROFILE_ID_CMDID,
460 /* Suspend resume command Ids */
461 WMI_PDEV_SUSPEND_CMDID = WMI_CMD_GRP(WMI_GRP_SUSPEND),
462 WMI_PDEV_RESUME_CMDID,
464 /* Beacon filter commands */
465 WMI_ADD_BCN_FILTER_CMDID = WMI_CMD_GRP(WMI_GRP_BCN_FILTER),
466 WMI_RMV_BCN_FILTER_CMDID,
468 /* WOW Specific WMI commands*/
469 WMI_WOW_ADD_WAKE_PATTERN_CMDID = WMI_CMD_GRP(WMI_GRP_WOW),
470 WMI_WOW_DEL_WAKE_PATTERN_CMDID,
471 WMI_WOW_ENABLE_DISABLE_WAKE_EVENT_CMDID,
472 WMI_WOW_ENABLE_CMDID,
473 WMI_WOW_HOSTWAKEUP_FROM_SLEEP_CMDID,
475 /* RTT measurement related cmd */
476 WMI_RTT_MEASREQ_CMDID = WMI_CMD_GRP(WMI_GRP_RTT),
479 /* spectral scan commands */
480 WMI_VDEV_SPECTRAL_SCAN_CONFIGURE_CMDID = WMI_CMD_GRP(WMI_GRP_SPECTRAL),
481 WMI_VDEV_SPECTRAL_SCAN_ENABLE_CMDID,
484 WMI_REQUEST_STATS_CMDID = WMI_CMD_GRP(WMI_GRP_STATS),
486 /* ARP OFFLOAD REQUEST*/
487 WMI_SET_ARP_NS_OFFLOAD_CMDID = WMI_CMD_GRP(WMI_GRP_ARP_NS_OFL),
489 /* NS offload confid*/
490 WMI_NETWORK_LIST_OFFLOAD_CONFIG_CMDID = WMI_CMD_GRP(WMI_GRP_NLO_OFL),
492 /* GTK offload Specific WMI commands*/
493 WMI_GTK_OFFLOAD_CMDID = WMI_CMD_GRP(WMI_GRP_GTK_OFL),
495 /* CSA offload Specific WMI commands*/
496 WMI_CSA_OFFLOAD_ENABLE_CMDID = WMI_CMD_GRP(WMI_GRP_CSA_OFL),
497 WMI_CSA_OFFLOAD_CHANSWITCH_CMDID,
499 /* Chatter commands*/
500 WMI_CHATTER_SET_MODE_CMDID = WMI_CMD_GRP(WMI_GRP_CHATTER),
502 /* addba specific commands */
503 WMI_PEER_TID_ADDBA_CMDID = WMI_CMD_GRP(WMI_GRP_TID_ADDBA),
504 WMI_PEER_TID_DELBA_CMDID,
506 /* set station mimo powersave method */
507 WMI_STA_DTIM_PS_METHOD_CMDID,
508 /* Configure the Station UAPSD AC Auto Trigger Parameters */
509 WMI_STA_UAPSD_AUTO_TRIG_CMDID,
511 /* STA Keep alive parameter configuration,
512 Requires WMI_SERVICE_STA_KEEP_ALIVE */
513 WMI_STA_KEEPALIVE_CMD,
515 /* misc command group */
516 WMI_ECHO_CMDID = WMI_CMD_GRP(WMI_GRP_MISC),
518 WMI_DBGLOG_CFG_CMDID,
520 WMI_PDEV_FTM_INTG_CMDID,
521 WMI_VDEV_SET_KEEPALIVE_CMDID,
522 WMI_VDEV_GET_KEEPALIVE_CMDID,
523 WMI_FORCE_FW_HANG_CMDID,
525 /* GPIO Configuration */
526 WMI_GPIO_CONFIG_CMDID = WMI_CMD_GRP(WMI_GRP_GPIO),
527 WMI_GPIO_OUTPUT_CMDID,
531 WMI_SERVICE_READY_EVENTID = 0x1,
534 /* Scan specific events */
535 WMI_SCAN_EVENTID = WMI_EVT_GRP_START_ID(WMI_GRP_SCAN),
537 /* PDEV specific events */
538 WMI_PDEV_TPC_CONFIG_EVENTID = WMI_EVT_GRP_START_ID(WMI_GRP_PDEV),
539 WMI_CHAN_INFO_EVENTID,
542 /* VDEV specific events */
543 WMI_VDEV_START_RESP_EVENTID = WMI_EVT_GRP_START_ID(WMI_GRP_VDEV),
544 WMI_VDEV_STOPPED_EVENTID,
545 WMI_VDEV_INSTALL_KEY_COMPLETE_EVENTID,
547 /* peer specific events */
548 WMI_PEER_STA_KICKOUT_EVENTID = WMI_EVT_GRP_START_ID(WMI_GRP_PEER),
550 /* beacon/mgmt specific events */
551 WMI_MGMT_RX_EVENTID = WMI_EVT_GRP_START_ID(WMI_GRP_MGMT),
552 WMI_HOST_SWBA_EVENTID,
553 WMI_TBTTOFFSET_UPDATE_EVENTID,
555 /* ADDBA Related WMI Events*/
556 WMI_TX_DELBA_COMPLETE_EVENTID = WMI_EVT_GRP_START_ID(WMI_GRP_BA_NEG),
557 WMI_TX_ADDBA_COMPLETE_EVENTID,
559 /* Roam event to trigger roaming on host */
560 WMI_ROAM_EVENTID = WMI_EVT_GRP_START_ID(WMI_GRP_ROAM),
564 WMI_WOW_WAKEUP_HOST_EVENTID = WMI_EVT_GRP_START_ID(WMI_GRP_WOW),
567 WMI_RTT_MEASUREMENT_REPORT_EVENTID = WMI_EVT_GRP_START_ID(WMI_GRP_RTT),
568 WMI_TSF_MEASUREMENT_REPORT_EVENTID,
569 WMI_RTT_ERROR_REPORT_EVENTID,
572 WMI_GTK_OFFLOAD_STATUS_EVENTID = WMI_EVT_GRP_START_ID(WMI_GRP_GTK_OFL),
573 WMI_GTK_REKEY_FAIL_EVENTID,
575 /* CSA IE received event */
576 WMI_CSA_HANDLING_EVENTID = WMI_EVT_GRP_START_ID(WMI_GRP_CSA_OFL),
579 WMI_ECHO_EVENTID = WMI_EVT_GRP_START_ID(WMI_GRP_MISC),
580 WMI_PDEV_UTF_EVENTID,
581 WMI_DEBUG_MESG_EVENTID,
582 WMI_UPDATE_STATS_EVENTID,
583 WMI_DEBUG_PRINT_EVENTID,
584 WMI_DCS_INTERFERENCE_EVENTID,
585 WMI_PDEV_QVIT_EVENTID,
586 WMI_WLAN_PROFILE_DATA_EVENTID,
587 WMI_PDEV_FTM_INTG_EVENTID,
588 WMI_WLAN_FREQ_AVOID_EVENTID,
589 WMI_VDEV_GET_KEEPALIVE_EVENTID,
592 WMI_GPIO_INPUT_EVENTID = WMI_EVT_GRP_START_ID(WMI_GRP_GPIO),
595 /* Command IDs and command events for 10.X firmware */
596 enum wmi_10x_cmd_id {
597 WMI_10X_START_CMDID = 0x9000,
598 WMI_10X_END_CMDID = 0x9FFF,
600 /* initialize the wlan sub system */
603 /* Scan specific commands */
605 WMI_10X_START_SCAN_CMDID = WMI_10X_START_CMDID,
606 WMI_10X_STOP_SCAN_CMDID,
607 WMI_10X_SCAN_CHAN_LIST_CMDID,
610 /* PDEV(physical device) specific commands */
611 WMI_10X_PDEV_SET_REGDOMAIN_CMDID,
612 WMI_10X_PDEV_SET_CHANNEL_CMDID,
613 WMI_10X_PDEV_SET_PARAM_CMDID,
614 WMI_10X_PDEV_PKTLOG_ENABLE_CMDID,
615 WMI_10X_PDEV_PKTLOG_DISABLE_CMDID,
616 WMI_10X_PDEV_SET_WMM_PARAMS_CMDID,
617 WMI_10X_PDEV_SET_HT_CAP_IE_CMDID,
618 WMI_10X_PDEV_SET_VHT_CAP_IE_CMDID,
619 WMI_10X_PDEV_SET_BASE_MACADDR_CMDID,
620 WMI_10X_PDEV_SET_DSCP_TID_MAP_CMDID,
621 WMI_10X_PDEV_SET_QUIET_MODE_CMDID,
622 WMI_10X_PDEV_GREEN_AP_PS_ENABLE_CMDID,
623 WMI_10X_PDEV_GET_TPC_CONFIG_CMDID,
625 /* VDEV(virtual device) specific commands */
626 WMI_10X_VDEV_CREATE_CMDID,
627 WMI_10X_VDEV_DELETE_CMDID,
628 WMI_10X_VDEV_START_REQUEST_CMDID,
629 WMI_10X_VDEV_RESTART_REQUEST_CMDID,
630 WMI_10X_VDEV_UP_CMDID,
631 WMI_10X_VDEV_STOP_CMDID,
632 WMI_10X_VDEV_DOWN_CMDID,
633 WMI_10X_VDEV_STANDBY_RESPONSE_CMDID,
634 WMI_10X_VDEV_RESUME_RESPONSE_CMDID,
635 WMI_10X_VDEV_SET_PARAM_CMDID,
636 WMI_10X_VDEV_INSTALL_KEY_CMDID,
638 /* peer specific commands */
639 WMI_10X_PEER_CREATE_CMDID,
640 WMI_10X_PEER_DELETE_CMDID,
641 WMI_10X_PEER_FLUSH_TIDS_CMDID,
642 WMI_10X_PEER_SET_PARAM_CMDID,
643 WMI_10X_PEER_ASSOC_CMDID,
644 WMI_10X_PEER_ADD_WDS_ENTRY_CMDID,
645 WMI_10X_PEER_REMOVE_WDS_ENTRY_CMDID,
646 WMI_10X_PEER_MCAST_GROUP_CMDID,
648 /* beacon/management specific commands */
650 WMI_10X_BCN_TX_CMDID,
651 WMI_10X_BCN_PRB_TMPL_CMDID,
652 WMI_10X_BCN_FILTER_RX_CMDID,
653 WMI_10X_PRB_REQ_FILTER_RX_CMDID,
654 WMI_10X_MGMT_TX_CMDID,
656 /* commands to directly control ba negotiation directly from host. */
657 WMI_10X_ADDBA_CLEAR_RESP_CMDID,
658 WMI_10X_ADDBA_SEND_CMDID,
659 WMI_10X_ADDBA_STATUS_CMDID,
660 WMI_10X_DELBA_SEND_CMDID,
661 WMI_10X_ADDBA_SET_RESP_CMDID,
662 WMI_10X_SEND_SINGLEAMSDU_CMDID,
664 /* Station power save specific config */
665 WMI_10X_STA_POWERSAVE_MODE_CMDID,
666 WMI_10X_STA_POWERSAVE_PARAM_CMDID,
667 WMI_10X_STA_MIMO_PS_MODE_CMDID,
669 /* set debug log config */
670 WMI_10X_DBGLOG_CFG_CMDID,
672 /* DFS-specific commands */
673 WMI_10X_PDEV_DFS_ENABLE_CMDID,
674 WMI_10X_PDEV_DFS_DISABLE_CMDID,
676 /* QVIT specific command id */
677 WMI_10X_PDEV_QVIT_CMDID,
679 /* Offload Scan and Roaming related commands */
680 WMI_10X_ROAM_SCAN_MODE,
681 WMI_10X_ROAM_SCAN_RSSI_THRESHOLD,
682 WMI_10X_ROAM_SCAN_PERIOD,
683 WMI_10X_ROAM_SCAN_RSSI_CHANGE_THRESHOLD,
684 WMI_10X_ROAM_AP_PROFILE,
685 WMI_10X_OFL_SCAN_ADD_AP_PROFILE,
686 WMI_10X_OFL_SCAN_REMOVE_AP_PROFILE,
687 WMI_10X_OFL_SCAN_PERIOD,
689 /* P2P specific commands */
690 WMI_10X_P2P_DEV_SET_DEVICE_INFO,
691 WMI_10X_P2P_DEV_SET_DISCOVERABILITY,
692 WMI_10X_P2P_GO_SET_BEACON_IE,
693 WMI_10X_P2P_GO_SET_PROBE_RESP_IE,
695 /* AP power save specific config */
696 WMI_10X_AP_PS_PEER_PARAM_CMDID,
697 WMI_10X_AP_PS_PEER_UAPSD_COEX_CMDID,
699 /* Rate-control specific commands */
700 WMI_10X_PEER_RATE_RETRY_SCHED_CMDID,
702 /* WLAN Profiling commands. */
703 WMI_10X_WLAN_PROFILE_TRIGGER_CMDID,
704 WMI_10X_WLAN_PROFILE_SET_HIST_INTVL_CMDID,
705 WMI_10X_WLAN_PROFILE_GET_PROFILE_DATA_CMDID,
706 WMI_10X_WLAN_PROFILE_ENABLE_PROFILE_ID_CMDID,
707 WMI_10X_WLAN_PROFILE_LIST_PROFILE_ID_CMDID,
709 /* Suspend resume command Ids */
710 WMI_10X_PDEV_SUSPEND_CMDID,
711 WMI_10X_PDEV_RESUME_CMDID,
713 /* Beacon filter commands */
714 WMI_10X_ADD_BCN_FILTER_CMDID,
715 WMI_10X_RMV_BCN_FILTER_CMDID,
717 /* WOW Specific WMI commands*/
718 WMI_10X_WOW_ADD_WAKE_PATTERN_CMDID,
719 WMI_10X_WOW_DEL_WAKE_PATTERN_CMDID,
720 WMI_10X_WOW_ENABLE_DISABLE_WAKE_EVENT_CMDID,
721 WMI_10X_WOW_ENABLE_CMDID,
722 WMI_10X_WOW_HOSTWAKEUP_FROM_SLEEP_CMDID,
724 /* RTT measurement related cmd */
725 WMI_10X_RTT_MEASREQ_CMDID,
726 WMI_10X_RTT_TSF_CMDID,
728 /* transmit beacon by value */
729 WMI_10X_PDEV_SEND_BCN_CMDID,
732 WMI_10X_VDEV_SPECTRAL_SCAN_CONFIGURE_CMDID,
733 WMI_10X_VDEV_SPECTRAL_SCAN_ENABLE_CMDID,
734 WMI_10X_REQUEST_STATS_CMDID,
736 /* GPIO Configuration */
737 WMI_10X_GPIO_CONFIG_CMDID,
738 WMI_10X_GPIO_OUTPUT_CMDID,
740 WMI_10X_PDEV_UTF_CMDID = WMI_10X_END_CMDID - 1,
743 enum wmi_10x_event_id {
744 WMI_10X_SERVICE_READY_EVENTID = 0x8000,
745 WMI_10X_READY_EVENTID,
746 WMI_10X_START_EVENTID = 0x9000,
747 WMI_10X_END_EVENTID = 0x9FFF,
749 /* Scan specific events */
750 WMI_10X_SCAN_EVENTID = WMI_10X_START_EVENTID,
751 WMI_10X_ECHO_EVENTID,
752 WMI_10X_DEBUG_MESG_EVENTID,
753 WMI_10X_UPDATE_STATS_EVENTID,
755 /* Instantaneous RSSI event */
756 WMI_10X_INST_RSSI_STATS_EVENTID,
758 /* VDEV specific events */
759 WMI_10X_VDEV_START_RESP_EVENTID,
760 WMI_10X_VDEV_STANDBY_REQ_EVENTID,
761 WMI_10X_VDEV_RESUME_REQ_EVENTID,
762 WMI_10X_VDEV_STOPPED_EVENTID,
764 /* peer specific events */
765 WMI_10X_PEER_STA_KICKOUT_EVENTID,
767 /* beacon/mgmt specific events */
768 WMI_10X_HOST_SWBA_EVENTID,
769 WMI_10X_TBTTOFFSET_UPDATE_EVENTID,
770 WMI_10X_MGMT_RX_EVENTID,
772 /* Channel stats event */
773 WMI_10X_CHAN_INFO_EVENTID,
775 /* PHY Error specific WMI event */
776 WMI_10X_PHYERR_EVENTID,
778 /* Roam event to trigger roaming on host */
779 WMI_10X_ROAM_EVENTID,
781 /* matching AP found from list of profiles */
782 WMI_10X_PROFILE_MATCH,
784 /* debug print message used for tracing FW code while debugging */
785 WMI_10X_DEBUG_PRINT_EVENTID,
786 /* VI spoecific event */
787 WMI_10X_PDEV_QVIT_EVENTID,
788 /* FW code profile data in response to profile request */
789 WMI_10X_WLAN_PROFILE_DATA_EVENTID,
791 /*RTT related event ID*/
792 WMI_10X_RTT_MEASUREMENT_REPORT_EVENTID,
793 WMI_10X_TSF_MEASUREMENT_REPORT_EVENTID,
794 WMI_10X_RTT_ERROR_REPORT_EVENTID,
796 WMI_10X_WOW_WAKEUP_HOST_EVENTID,
797 WMI_10X_DCS_INTERFERENCE_EVENTID,
799 /* TPC config for the current operating channel */
800 WMI_10X_PDEV_TPC_CONFIG_EVENTID,
802 WMI_10X_GPIO_INPUT_EVENTID,
803 WMI_10X_PDEV_UTF_EVENTID = WMI_10X_END_EVENTID-1,
807 MODE_11A = 0, /* 11a Mode */
808 MODE_11G = 1, /* 11b/g Mode */
809 MODE_11B = 2, /* 11b Mode */
810 MODE_11GONLY = 3, /* 11g only Mode */
811 MODE_11NA_HT20 = 4, /* 11a HT20 mode */
812 MODE_11NG_HT20 = 5, /* 11g HT20 mode */
813 MODE_11NA_HT40 = 6, /* 11a HT40 mode */
814 MODE_11NG_HT40 = 7, /* 11g HT40 mode */
817 MODE_11AC_VHT80 = 10,
818 /* MODE_11AC_VHT160 = 11, */
819 MODE_11AC_VHT20_2G = 11,
820 MODE_11AC_VHT40_2G = 12,
821 MODE_11AC_VHT80_2G = 13,
826 static inline const char *ath10k_wmi_phymode_str(enum wmi_phy_mode mode)
845 case MODE_11AC_VHT20:
847 case MODE_11AC_VHT40:
849 case MODE_11AC_VHT80:
851 case MODE_11AC_VHT20_2G:
852 return "11ac-vht20-2g";
853 case MODE_11AC_VHT40_2G:
854 return "11ac-vht40-2g";
855 case MODE_11AC_VHT80_2G:
856 return "11ac-vht80-2g";
861 /* no default handler to allow compiler to check that the
862 * enum is fully handled */
868 #define WMI_CHAN_LIST_TAG 0x1
869 #define WMI_SSID_LIST_TAG 0x2
870 #define WMI_BSSID_LIST_TAG 0x3
871 #define WMI_IE_TAG 0x4
875 __le32 band_center_freq1;
876 __le32 band_center_freq2; /* valid for 11ac, 80plus80 */
878 __le32 flags; /* WMI_CHAN_FLAG_ */
880 u8 mode; /* only 6 LSBs */
886 /* note: power unit is 0.5 dBm */
901 struct wmi_channel_arg {
903 u32 band_center_freq1;
910 /* note: power unit is 0.5 dBm */
914 u32 max_antenna_gain;
916 enum wmi_phy_mode mode;
919 enum wmi_channel_change_cause {
920 WMI_CHANNEL_CHANGE_CAUSE_NONE = 0,
921 WMI_CHANNEL_CHANGE_CAUSE_CSA,
924 #define WMI_CHAN_FLAG_HT40_PLUS (1 << 6)
925 #define WMI_CHAN_FLAG_PASSIVE (1 << 7)
926 #define WMI_CHAN_FLAG_ADHOC_ALLOWED (1 << 8)
927 #define WMI_CHAN_FLAG_AP_DISABLED (1 << 9)
928 #define WMI_CHAN_FLAG_DFS (1 << 10)
929 #define WMI_CHAN_FLAG_ALLOW_HT (1 << 11)
930 #define WMI_CHAN_FLAG_ALLOW_VHT (1 << 12)
932 /* Indicate reason for channel switch */
933 #define WMI_CHANNEL_CHANGE_CAUSE_CSA (1 << 13)
935 #define WMI_MAX_SPATIAL_STREAM 3
938 #define WMI_HT_CAP_ENABLED 0x0001 /* HT Enabled/ disabled */
939 #define WMI_HT_CAP_HT20_SGI 0x0002 /* Short Guard Interval with HT20 */
940 #define WMI_HT_CAP_DYNAMIC_SMPS 0x0004 /* Dynamic MIMO powersave */
941 #define WMI_HT_CAP_TX_STBC 0x0008 /* B3 TX STBC */
942 #define WMI_HT_CAP_TX_STBC_MASK_SHIFT 3
943 #define WMI_HT_CAP_RX_STBC 0x0030 /* B4-B5 RX STBC */
944 #define WMI_HT_CAP_RX_STBC_MASK_SHIFT 4
945 #define WMI_HT_CAP_LDPC 0x0040 /* LDPC supported */
946 #define WMI_HT_CAP_L_SIG_TXOP_PROT 0x0080 /* L-SIG TXOP Protection */
947 #define WMI_HT_CAP_MPDU_DENSITY 0x0700 /* MPDU Density */
948 #define WMI_HT_CAP_MPDU_DENSITY_MASK_SHIFT 8
949 #define WMI_HT_CAP_HT40_SGI 0x0800
951 #define WMI_HT_CAP_DEFAULT_ALL (WMI_HT_CAP_ENABLED | \
952 WMI_HT_CAP_HT20_SGI | \
953 WMI_HT_CAP_HT40_SGI | \
954 WMI_HT_CAP_TX_STBC | \
955 WMI_HT_CAP_RX_STBC | \
960 * WMI_VHT_CAP_* these maps to ieee 802.11ac vht capability information
961 * field. The fields not defined here are not supported, or reserved.
962 * Do not change these masks and if you have to add new one follow the
963 * bitmask as specified by 802.11ac draft.
966 #define WMI_VHT_CAP_MAX_MPDU_LEN_MASK 0x00000003
967 #define WMI_VHT_CAP_RX_LDPC 0x00000010
968 #define WMI_VHT_CAP_SGI_80MHZ 0x00000020
969 #define WMI_VHT_CAP_TX_STBC 0x00000080
970 #define WMI_VHT_CAP_RX_STBC_MASK 0x00000300
971 #define WMI_VHT_CAP_RX_STBC_MASK_SHIFT 8
972 #define WMI_VHT_CAP_MAX_AMPDU_LEN_EXP 0x03800000
973 #define WMI_VHT_CAP_MAX_AMPDU_LEN_EXP_SHIFT 23
974 #define WMI_VHT_CAP_RX_FIXED_ANT 0x10000000
975 #define WMI_VHT_CAP_TX_FIXED_ANT 0x20000000
977 /* The following also refer for max HT AMSDU */
978 #define WMI_VHT_CAP_MAX_MPDU_LEN_3839 0x00000000
979 #define WMI_VHT_CAP_MAX_MPDU_LEN_7935 0x00000001
980 #define WMI_VHT_CAP_MAX_MPDU_LEN_11454 0x00000002
982 #define WMI_VHT_CAP_DEFAULT_ALL (WMI_VHT_CAP_MAX_MPDU_LEN_11454 | \
983 WMI_VHT_CAP_RX_LDPC | \
984 WMI_VHT_CAP_SGI_80MHZ | \
985 WMI_VHT_CAP_TX_STBC | \
986 WMI_VHT_CAP_RX_STBC_MASK | \
987 WMI_VHT_CAP_MAX_AMPDU_LEN_EXP | \
988 WMI_VHT_CAP_RX_FIXED_ANT | \
989 WMI_VHT_CAP_TX_FIXED_ANT)
992 * Interested readers refer to Rx/Tx MCS Map definition as defined in
995 #define WMI_VHT_MAX_MCS_4_SS_MASK(r, ss) ((3 & (r)) << (((ss) - 1) << 1))
996 #define WMI_VHT_MAX_SUPP_RATE_MASK 0x1fff0000
997 #define WMI_VHT_MAX_SUPP_RATE_MASK_SHIFT 16
1000 REGDMN_MODE_11A = 0x00001, /* 11a channels */
1001 REGDMN_MODE_TURBO = 0x00002, /* 11a turbo-only channels */
1002 REGDMN_MODE_11B = 0x00004, /* 11b channels */
1003 REGDMN_MODE_PUREG = 0x00008, /* 11g channels (OFDM only) */
1004 REGDMN_MODE_11G = 0x00008, /* XXX historical */
1005 REGDMN_MODE_108G = 0x00020, /* 11a+Turbo channels */
1006 REGDMN_MODE_108A = 0x00040, /* 11g+Turbo channels */
1007 REGDMN_MODE_XR = 0x00100, /* XR channels */
1008 REGDMN_MODE_11A_HALF_RATE = 0x00200, /* 11A half rate channels */
1009 REGDMN_MODE_11A_QUARTER_RATE = 0x00400, /* 11A quarter rate channels */
1010 REGDMN_MODE_11NG_HT20 = 0x00800, /* 11N-G HT20 channels */
1011 REGDMN_MODE_11NA_HT20 = 0x01000, /* 11N-A HT20 channels */
1012 REGDMN_MODE_11NG_HT40PLUS = 0x02000, /* 11N-G HT40 + channels */
1013 REGDMN_MODE_11NG_HT40MINUS = 0x04000, /* 11N-G HT40 - channels */
1014 REGDMN_MODE_11NA_HT40PLUS = 0x08000, /* 11N-A HT40 + channels */
1015 REGDMN_MODE_11NA_HT40MINUS = 0x10000, /* 11N-A HT40 - channels */
1016 REGDMN_MODE_11AC_VHT20 = 0x20000, /* 5Ghz, VHT20 */
1017 REGDMN_MODE_11AC_VHT40PLUS = 0x40000, /* 5Ghz, VHT40 + channels */
1018 REGDMN_MODE_11AC_VHT40MINUS = 0x80000, /* 5Ghz VHT40 - channels */
1019 REGDMN_MODE_11AC_VHT80 = 0x100000, /* 5Ghz, VHT80 channels */
1020 REGDMN_MODE_ALL = 0xffffffff
1023 #define REGDMN_CAP1_CHAN_HALF_RATE 0x00000001
1024 #define REGDMN_CAP1_CHAN_QUARTER_RATE 0x00000002
1025 #define REGDMN_CAP1_CHAN_HAL49GHZ 0x00000004
1027 /* regulatory capabilities */
1028 #define REGDMN_EEPROM_EEREGCAP_EN_FCC_MIDBAND 0x0040
1029 #define REGDMN_EEPROM_EEREGCAP_EN_KK_U1_EVEN 0x0080
1030 #define REGDMN_EEPROM_EEREGCAP_EN_KK_U2 0x0100
1031 #define REGDMN_EEPROM_EEREGCAP_EN_KK_MIDBAND 0x0200
1032 #define REGDMN_EEPROM_EEREGCAP_EN_KK_U1_ODD 0x0400
1033 #define REGDMN_EEPROM_EEREGCAP_EN_KK_NEW_11A 0x0800
1035 struct hal_reg_capabilities {
1036 /* regdomain value specified in EEPROM */
1039 __le32 eeprom_rd_ext;
1040 /* CAP1 capabilities bit map. */
1042 /* REGDMN EEPROM CAP. */
1045 __le32 wireless_modes;
1046 __le32 low_2ghz_chan;
1047 __le32 high_2ghz_chan;
1048 __le32 low_5ghz_chan;
1049 __le32 high_5ghz_chan;
1052 enum wlan_mode_capability {
1053 WHAL_WLAN_11A_CAPABILITY = 0x1,
1054 WHAL_WLAN_11G_CAPABILITY = 0x2,
1055 WHAL_WLAN_11AG_CAPABILITY = 0x3,
1058 /* structure used by FW for requesting host memory */
1059 struct wlan_host_mem_req {
1060 /* ID of the request */
1062 /* size of the of each unit */
1064 /* flags to indicate that
1065 * the number units is dependent
1066 * on number of resources(num vdevs num peers .. etc)
1068 __le32 num_unit_info;
1070 * actual number of units to allocate . if flags in the num_unit_info
1071 * indicate that number of units is tied to number of a particular
1072 * resource to allocate then num_units filed is set to 0 and host
1073 * will derive the number units from number of the resources it is
1079 #define WMI_SERVICE_IS_ENABLED(wmi_svc_bmap, svc_id) \
1080 ((((wmi_svc_bmap)[(svc_id)/(sizeof(u32))]) & \
1081 (1 << ((svc_id)%(sizeof(u32))))) != 0)
1084 * The following struct holds optional payload for
1085 * wmi_service_ready_event,e.g., 11ac pass some of the
1086 * device capability to the host.
1088 struct wmi_service_ready_event {
1090 __le32 sw_version_1;
1092 /* WMI_PHY_CAPABILITY */
1093 __le32 phy_capability;
1094 /* Maximum number of frag table entries that SW will populate less 1 */
1095 __le32 max_frag_entry;
1096 __le32 wmi_service_bitmap[WMI_SERVICE_BM_SIZE];
1097 __le32 num_rf_chains;
1099 * The following field is only valid for service type
1102 __le32 ht_cap_info; /* WMI HT Capability */
1103 __le32 vht_cap_info; /* VHT capability info field of 802.11ac */
1104 __le32 vht_supp_mcs; /* VHT Supported MCS Set field Rx/Tx same */
1105 __le32 hw_min_tx_power;
1106 __le32 hw_max_tx_power;
1107 struct hal_reg_capabilities hal_reg_capabilities;
1108 __le32 sys_cap_info;
1109 __le32 min_pkt_size_enable; /* Enterprise mode short pkt enable */
1111 * Max beacon and Probe Response IE offload size
1112 * (includes optional P2P IEs)
1114 __le32 max_bcn_ie_size;
1116 * request to host to allocate a chuck of memory and pss it down to FW
1117 * via WM_INIT. FW uses this as FW extesnsion memory for saving its
1118 * data structures. Only valid for low latency interfaces like PCIE
1119 * where FW can access this memory directly (or) by DMA.
1121 __le32 num_mem_reqs;
1122 struct wlan_host_mem_req mem_reqs[1];
1125 /* This is the definition from 10.X firmware branch */
1126 struct wmi_service_ready_event_10x {
1130 /* WMI_PHY_CAPABILITY */
1131 __le32 phy_capability;
1133 /* Maximum number of frag table entries that SW will populate less 1 */
1134 __le32 max_frag_entry;
1135 __le32 wmi_service_bitmap[WMI_SERVICE_BM_SIZE];
1136 __le32 num_rf_chains;
1139 * The following field is only valid for service type
1142 __le32 ht_cap_info; /* WMI HT Capability */
1143 __le32 vht_cap_info; /* VHT capability info field of 802.11ac */
1144 __le32 vht_supp_mcs; /* VHT Supported MCS Set field Rx/Tx same */
1145 __le32 hw_min_tx_power;
1146 __le32 hw_max_tx_power;
1148 struct hal_reg_capabilities hal_reg_capabilities;
1150 __le32 sys_cap_info;
1151 __le32 min_pkt_size_enable; /* Enterprise mode short pkt enable */
1154 * request to host to allocate a chuck of memory and pss it down to FW
1155 * via WM_INIT. FW uses this as FW extesnsion memory for saving its
1156 * data structures. Only valid for low latency interfaces like PCIE
1157 * where FW can access this memory directly (or) by DMA.
1159 __le32 num_mem_reqs;
1161 struct wlan_host_mem_req mem_reqs[1];
1165 #define WMI_SERVICE_READY_TIMEOUT_HZ (5*HZ)
1166 #define WMI_UNIFIED_READY_TIMEOUT_HZ (5*HZ)
1168 struct wmi_ready_event {
1171 struct wmi_mac_addr mac_addr;
1175 struct wmi_resource_config {
1176 /* number of virtual devices (VAPs) to support */
1179 /* number of peer nodes to support */
1183 * In offload mode target supports features like WOW, chatter and
1184 * other protocol offloads. In order to support them some
1185 * functionalities like reorder buffering, PN checking need to be
1186 * done in target. This determines maximum number of peers suported
1187 * by target in offload mode
1189 __le32 num_offload_peers;
1191 /* For target-based RX reordering */
1192 __le32 num_offload_reorder_bufs;
1194 /* number of keys per peer */
1195 __le32 num_peer_keys;
1197 /* total number of TX/RX data TIDs */
1201 * max skid for resolving hash collisions
1203 * The address search table is sparse, so that if two MAC addresses
1204 * result in the same hash value, the second of these conflicting
1205 * entries can slide to the next index in the address search table,
1206 * and use it, if it is unoccupied. This ast_skid_limit parameter
1207 * specifies the upper bound on how many subsequent indices to search
1208 * over to find an unoccupied space.
1210 __le32 ast_skid_limit;
1213 * the nominal chain mask for transmit
1215 * The chain mask may be modified dynamically, e.g. to operate AP
1216 * tx with a reduced number of chains if no clients are associated.
1217 * This configuration parameter specifies the nominal chain-mask that
1218 * should be used when not operating with a reduced set of tx chains.
1220 __le32 tx_chain_mask;
1223 * the nominal chain mask for receive
1225 * The chain mask may be modified dynamically, e.g. for a client
1226 * to use a reduced number of chains for receive if the traffic to
1227 * the client is low enough that it doesn't require downlink MIMO
1228 * or antenna diversity.
1229 * This configuration parameter specifies the nominal chain-mask that
1230 * should be used when not operating with a reduced set of rx chains.
1232 __le32 rx_chain_mask;
1235 * what rx reorder timeout (ms) to use for the AC
1237 * Each WMM access class (voice, video, best-effort, background) will
1238 * have its own timeout value to dictate how long to wait for missing
1239 * rx MPDUs to arrive before flushing subsequent MPDUs that have
1240 * already been received.
1241 * This parameter specifies the timeout in milliseconds for each
1244 __le32 rx_timeout_pri_vi;
1245 __le32 rx_timeout_pri_vo;
1246 __le32 rx_timeout_pri_be;
1247 __le32 rx_timeout_pri_bk;
1250 * what mode the rx should decap packets to
1252 * MAC can decap to RAW (no decap), native wifi or Ethernet types
1253 * THis setting also determines the default TX behavior, however TX
1254 * behavior can be modified on a per VAP basis during VAP init
1256 __le32 rx_decap_mode;
1258 /* what is the maximum number of scan requests that can be queued */
1259 __le32 scan_max_pending_reqs;
1261 /* maximum VDEV that could use BMISS offload */
1262 __le32 bmiss_offload_max_vdev;
1264 /* maximum VDEV that could use offload roaming */
1265 __le32 roam_offload_max_vdev;
1267 /* maximum AP profiles that would push to offload roaming */
1268 __le32 roam_offload_max_ap_profiles;
1271 * how many groups to use for mcast->ucast conversion
1273 * The target's WAL maintains a table to hold information regarding
1274 * which peers belong to a given multicast group, so that if
1275 * multicast->unicast conversion is enabled, the target can convert
1276 * multicast tx frames to a series of unicast tx frames, to each
1277 * peer within the multicast group.
1278 This num_mcast_groups configuration parameter tells the target how
1279 * many multicast groups to provide storage for within its multicast
1280 * group membership table.
1282 __le32 num_mcast_groups;
1285 * size to alloc for the mcast membership table
1287 * This num_mcast_table_elems configuration parameter tells the
1288 * target how many peer elements it needs to provide storage for in
1289 * its multicast group membership table.
1290 * These multicast group membership table elements are shared by the
1291 * multicast groups stored within the table.
1293 __le32 num_mcast_table_elems;
1296 * whether/how to do multicast->unicast conversion
1298 * This configuration parameter specifies whether the target should
1299 * perform multicast --> unicast conversion on transmit, and if so,
1300 * what to do if it finds no entries in its multicast group
1301 * membership table for the multicast IP address in the tx frame.
1302 * Configuration value:
1303 * 0 -> Do not perform multicast to unicast conversion.
1304 * 1 -> Convert multicast frames to unicast, if the IP multicast
1305 * address from the tx frame is found in the multicast group
1306 * membership table. If the IP multicast address is not found,
1308 * 2 -> Convert multicast frames to unicast, if the IP multicast
1309 * address from the tx frame is found in the multicast group
1310 * membership table. If the IP multicast address is not found,
1311 * transmit the frame as multicast.
1313 __le32 mcast2ucast_mode;
1316 * how much memory to allocate for a tx PPDU dbg log
1318 * This parameter controls how much memory the target will allocate
1319 * to store a log of tx PPDU meta-information (how large the PPDU
1320 * was, when it was sent, whether it was successful, etc.)
1322 __le32 tx_dbg_log_size;
1324 /* how many AST entries to be allocated for WDS */
1325 __le32 num_wds_entries;
1328 * MAC DMA burst size, e.g., For target PCI limit can be
1329 * 0 -default, 1 256B
1331 __le32 dma_burst_size;
1334 * Fixed delimiters to be inserted after every MPDU to
1335 * account for interface latency to avoid underrun.
1337 __le32 mac_aggr_delim;
1340 * determine whether target is responsible for detecting duplicate
1341 * non-aggregate MPDU and timing out stale fragments.
1343 * A-MPDU reordering is always performed on the target.
1345 * 0: target responsible for frag timeout and dup checking
1346 * 1: host responsible for frag timeout and dup checking
1348 __le32 rx_skip_defrag_timeout_dup_detection_check;
1351 * Configuration for VoW :
1352 * No of Video Nodes to be supported
1353 * and Max no of descriptors for each Video link (node).
1357 /* maximum VDEV that could use GTK offload */
1358 __le32 gtk_offload_max_vdev;
1360 /* Number of msdu descriptors target should use */
1361 __le32 num_msdu_desc;
1364 * Max. number of Tx fragments per MSDU
1365 * This parameter controls the max number of Tx fragments per MSDU.
1366 * This is sent by the target as part of the WMI_SERVICE_READY event
1367 * and is overriden by the OS shim as required.
1369 __le32 max_frag_entries;
1372 struct wmi_resource_config_10x {
1373 /* number of virtual devices (VAPs) to support */
1376 /* number of peer nodes to support */
1379 /* number of keys per peer */
1380 __le32 num_peer_keys;
1382 /* total number of TX/RX data TIDs */
1386 * max skid for resolving hash collisions
1388 * The address search table is sparse, so that if two MAC addresses
1389 * result in the same hash value, the second of these conflicting
1390 * entries can slide to the next index in the address search table,
1391 * and use it, if it is unoccupied. This ast_skid_limit parameter
1392 * specifies the upper bound on how many subsequent indices to search
1393 * over to find an unoccupied space.
1395 __le32 ast_skid_limit;
1398 * the nominal chain mask for transmit
1400 * The chain mask may be modified dynamically, e.g. to operate AP
1401 * tx with a reduced number of chains if no clients are associated.
1402 * This configuration parameter specifies the nominal chain-mask that
1403 * should be used when not operating with a reduced set of tx chains.
1405 __le32 tx_chain_mask;
1408 * the nominal chain mask for receive
1410 * The chain mask may be modified dynamically, e.g. for a client
1411 * to use a reduced number of chains for receive if the traffic to
1412 * the client is low enough that it doesn't require downlink MIMO
1413 * or antenna diversity.
1414 * This configuration parameter specifies the nominal chain-mask that
1415 * should be used when not operating with a reduced set of rx chains.
1417 __le32 rx_chain_mask;
1420 * what rx reorder timeout (ms) to use for the AC
1422 * Each WMM access class (voice, video, best-effort, background) will
1423 * have its own timeout value to dictate how long to wait for missing
1424 * rx MPDUs to arrive before flushing subsequent MPDUs that have
1425 * already been received.
1426 * This parameter specifies the timeout in milliseconds for each
1429 __le32 rx_timeout_pri_vi;
1430 __le32 rx_timeout_pri_vo;
1431 __le32 rx_timeout_pri_be;
1432 __le32 rx_timeout_pri_bk;
1435 * what mode the rx should decap packets to
1437 * MAC can decap to RAW (no decap), native wifi or Ethernet types
1438 * THis setting also determines the default TX behavior, however TX
1439 * behavior can be modified on a per VAP basis during VAP init
1441 __le32 rx_decap_mode;
1443 /* what is the maximum number of scan requests that can be queued */
1444 __le32 scan_max_pending_reqs;
1446 /* maximum VDEV that could use BMISS offload */
1447 __le32 bmiss_offload_max_vdev;
1449 /* maximum VDEV that could use offload roaming */
1450 __le32 roam_offload_max_vdev;
1452 /* maximum AP profiles that would push to offload roaming */
1453 __le32 roam_offload_max_ap_profiles;
1456 * how many groups to use for mcast->ucast conversion
1458 * The target's WAL maintains a table to hold information regarding
1459 * which peers belong to a given multicast group, so that if
1460 * multicast->unicast conversion is enabled, the target can convert
1461 * multicast tx frames to a series of unicast tx frames, to each
1462 * peer within the multicast group.
1463 This num_mcast_groups configuration parameter tells the target how
1464 * many multicast groups to provide storage for within its multicast
1465 * group membership table.
1467 __le32 num_mcast_groups;
1470 * size to alloc for the mcast membership table
1472 * This num_mcast_table_elems configuration parameter tells the
1473 * target how many peer elements it needs to provide storage for in
1474 * its multicast group membership table.
1475 * These multicast group membership table elements are shared by the
1476 * multicast groups stored within the table.
1478 __le32 num_mcast_table_elems;
1481 * whether/how to do multicast->unicast conversion
1483 * This configuration parameter specifies whether the target should
1484 * perform multicast --> unicast conversion on transmit, and if so,
1485 * what to do if it finds no entries in its multicast group
1486 * membership table for the multicast IP address in the tx frame.
1487 * Configuration value:
1488 * 0 -> Do not perform multicast to unicast conversion.
1489 * 1 -> Convert multicast frames to unicast, if the IP multicast
1490 * address from the tx frame is found in the multicast group
1491 * membership table. If the IP multicast address is not found,
1493 * 2 -> Convert multicast frames to unicast, if the IP multicast
1494 * address from the tx frame is found in the multicast group
1495 * membership table. If the IP multicast address is not found,
1496 * transmit the frame as multicast.
1498 __le32 mcast2ucast_mode;
1501 * how much memory to allocate for a tx PPDU dbg log
1503 * This parameter controls how much memory the target will allocate
1504 * to store a log of tx PPDU meta-information (how large the PPDU
1505 * was, when it was sent, whether it was successful, etc.)
1507 __le32 tx_dbg_log_size;
1509 /* how many AST entries to be allocated for WDS */
1510 __le32 num_wds_entries;
1513 * MAC DMA burst size, e.g., For target PCI limit can be
1514 * 0 -default, 1 256B
1516 __le32 dma_burst_size;
1519 * Fixed delimiters to be inserted after every MPDU to
1520 * account for interface latency to avoid underrun.
1522 __le32 mac_aggr_delim;
1525 * determine whether target is responsible for detecting duplicate
1526 * non-aggregate MPDU and timing out stale fragments.
1528 * A-MPDU reordering is always performed on the target.
1530 * 0: target responsible for frag timeout and dup checking
1531 * 1: host responsible for frag timeout and dup checking
1533 __le32 rx_skip_defrag_timeout_dup_detection_check;
1536 * Configuration for VoW :
1537 * No of Video Nodes to be supported
1538 * and Max no of descriptors for each Video link (node).
1542 /* Number of msdu descriptors target should use */
1543 __le32 num_msdu_desc;
1546 * Max. number of Tx fragments per MSDU
1547 * This parameter controls the max number of Tx fragments per MSDU.
1548 * This is sent by the target as part of the WMI_SERVICE_READY event
1549 * and is overriden by the OS shim as required.
1551 __le32 max_frag_entries;
1555 #define NUM_UNITS_IS_NUM_VDEVS 0x1
1556 #define NUM_UNITS_IS_NUM_PEERS 0x2
1558 /* strucutre describing host memory chunk. */
1559 struct host_memory_chunk {
1560 /* id of the request that is passed up in service ready */
1562 /* the physical address the memory chunk */
1564 /* size of the chunk */
1568 struct wmi_init_cmd {
1569 struct wmi_resource_config resource_config;
1570 __le32 num_host_mem_chunks;
1573 * variable number of host memory chunks.
1574 * This should be the last element in the structure
1576 struct host_memory_chunk host_mem_chunks[1];
1579 /* _10x stucture is from 10.X FW API */
1580 struct wmi_init_cmd_10x {
1581 struct wmi_resource_config_10x resource_config;
1582 __le32 num_host_mem_chunks;
1585 * variable number of host memory chunks.
1586 * This should be the last element in the structure
1588 struct host_memory_chunk host_mem_chunks[1];
1591 /* TLV for channel list */
1592 struct wmi_chan_list {
1593 __le32 tag; /* WMI_CHAN_LIST_TAG */
1595 __le32 channel_list[0];
1598 struct wmi_bssid_list {
1599 __le32 tag; /* WMI_BSSID_LIST_TAG */
1601 struct wmi_mac_addr bssid_list[0];
1604 struct wmi_ie_data {
1605 __le32 tag; /* WMI_IE_TAG */
1615 struct wmi_ssid_list {
1616 __le32 tag; /* WMI_SSID_LIST_TAG */
1618 struct wmi_ssid ssids[0];
1621 /* prefix used by scan requestor ids on the host */
1622 #define WMI_HOST_SCAN_REQUESTOR_ID_PREFIX 0xA000
1624 /* prefix used by scan request ids generated on the host */
1625 /* host cycles through the lower 12 bits to generate ids */
1626 #define WMI_HOST_SCAN_REQ_ID_PREFIX 0xA000
1628 #define WLAN_SCAN_PARAMS_MAX_SSID 16
1629 #define WLAN_SCAN_PARAMS_MAX_BSSID 4
1630 #define WLAN_SCAN_PARAMS_MAX_IE_LEN 256
1632 /* Scan priority numbers must be sequential, starting with 0 */
1633 enum wmi_scan_priority {
1634 WMI_SCAN_PRIORITY_VERY_LOW = 0,
1635 WMI_SCAN_PRIORITY_LOW,
1636 WMI_SCAN_PRIORITY_MEDIUM,
1637 WMI_SCAN_PRIORITY_HIGH,
1638 WMI_SCAN_PRIORITY_VERY_HIGH,
1639 WMI_SCAN_PRIORITY_COUNT /* number of priorities supported */
1642 struct wmi_start_scan_cmd {
1645 /* Scan requestor ID */
1647 /* VDEV id(interface) that is requesting scan */
1649 /* Scan Priority, input to scan scheduler */
1650 __le32 scan_priority;
1651 /* Scan events subscription */
1652 __le32 notify_scan_events;
1653 /* dwell time in msec on active channels */
1654 __le32 dwell_time_active;
1655 /* dwell time in msec on passive channels */
1656 __le32 dwell_time_passive;
1658 * min time in msec on the BSS channel,only valid if atleast one
1661 __le32 min_rest_time;
1663 * max rest time in msec on the BSS channel,only valid if at least
1664 * one VDEV is active
1667 * the scanner will rest on the bss channel at least min_rest_time
1668 * after min_rest_time the scanner will start checking for tx/rx
1669 * activity on all VDEVs. if there is no activity the scanner will
1670 * switch to off channel. if there is activity the scanner will let
1671 * the radio on the bss channel until max_rest_time expires.at
1672 * max_rest_time scanner will switch to off channel irrespective of
1673 * activity. activity is determined by the idle_time parameter.
1675 __le32 max_rest_time;
1677 * time before sending next set of probe requests.
1678 * The scanner keeps repeating probe requests transmission with
1679 * period specified by repeat_probe_time.
1680 * The number of probe requests specified depends on the ssid_list
1683 __le32 repeat_probe_time;
1684 /* time in msec between 2 consequetive probe requests with in a set. */
1685 __le32 probe_spacing_time;
1687 * data inactivity time in msec on bss channel that will be used by
1688 * scanner for measuring the inactivity.
1691 /* maximum time in msec allowed for scan */
1692 __le32 max_scan_time;
1694 * delay in msec before sending first probe request after switching
1698 /* Scan control flags */
1699 __le32 scan_ctrl_flags;
1701 /* Burst duration time in msecs */
1702 __le32 burst_duration;
1704 * TLV (tag length value ) paramerters follow the scan_cmd structure.
1705 * TLV can contain channel list, bssid list, ssid list and
1706 * ie. the TLV tags are defined above;
1710 /* This is the definition from 10.X firmware branch */
1711 struct wmi_start_scan_cmd_10x {
1715 /* Scan requestor ID */
1718 /* VDEV id(interface) that is requesting scan */
1721 /* Scan Priority, input to scan scheduler */
1722 __le32 scan_priority;
1724 /* Scan events subscription */
1725 __le32 notify_scan_events;
1727 /* dwell time in msec on active channels */
1728 __le32 dwell_time_active;
1730 /* dwell time in msec on passive channels */
1731 __le32 dwell_time_passive;
1734 * min time in msec on the BSS channel,only valid if atleast one
1737 __le32 min_rest_time;
1740 * max rest time in msec on the BSS channel,only valid if at least
1741 * one VDEV is active
1744 * the scanner will rest on the bss channel at least min_rest_time
1745 * after min_rest_time the scanner will start checking for tx/rx
1746 * activity on all VDEVs. if there is no activity the scanner will
1747 * switch to off channel. if there is activity the scanner will let
1748 * the radio on the bss channel until max_rest_time expires.at
1749 * max_rest_time scanner will switch to off channel irrespective of
1750 * activity. activity is determined by the idle_time parameter.
1752 __le32 max_rest_time;
1755 * time before sending next set of probe requests.
1756 * The scanner keeps repeating probe requests transmission with
1757 * period specified by repeat_probe_time.
1758 * The number of probe requests specified depends on the ssid_list
1761 __le32 repeat_probe_time;
1763 /* time in msec between 2 consequetive probe requests with in a set. */
1764 __le32 probe_spacing_time;
1767 * data inactivity time in msec on bss channel that will be used by
1768 * scanner for measuring the inactivity.
1772 /* maximum time in msec allowed for scan */
1773 __le32 max_scan_time;
1776 * delay in msec before sending first probe request after switching
1781 /* Scan control flags */
1782 __le32 scan_ctrl_flags;
1785 * TLV (tag length value ) paramerters follow the scan_cmd structure.
1786 * TLV can contain channel list, bssid list, ssid list and
1787 * ie. the TLV tags are defined above;
1792 struct wmi_ssid_arg {
1797 struct wmi_bssid_arg {
1801 struct wmi_start_scan_arg {
1806 u32 notify_scan_events;
1807 u32 dwell_time_active;
1808 u32 dwell_time_passive;
1811 u32 repeat_probe_time;
1812 u32 probe_spacing_time;
1816 u32 scan_ctrl_flags;
1823 u8 ie[WLAN_SCAN_PARAMS_MAX_IE_LEN];
1825 struct wmi_ssid_arg ssids[WLAN_SCAN_PARAMS_MAX_SSID];
1826 struct wmi_bssid_arg bssids[WLAN_SCAN_PARAMS_MAX_BSSID];
1829 /* scan control flags */
1831 /* passively scan all channels including active channels */
1832 #define WMI_SCAN_FLAG_PASSIVE 0x1
1833 /* add wild card ssid probe request even though ssid_list is specified. */
1834 #define WMI_SCAN_ADD_BCAST_PROBE_REQ 0x2
1835 /* add cck rates to rates/xrate ie for the generated probe request */
1836 #define WMI_SCAN_ADD_CCK_RATES 0x4
1837 /* add ofdm rates to rates/xrate ie for the generated probe request */
1838 #define WMI_SCAN_ADD_OFDM_RATES 0x8
1839 /* To enable indication of Chan load and Noise floor to host */
1840 #define WMI_SCAN_CHAN_STAT_EVENT 0x10
1841 /* Filter Probe request frames */
1842 #define WMI_SCAN_FILTER_PROBE_REQ 0x20
1843 /* When set, DFS channels will not be scanned */
1844 #define WMI_SCAN_BYPASS_DFS_CHN 0x40
1845 /* Different FW scan engine may choose to bail out on errors.
1846 * Allow the driver to have influence over that. */
1847 #define WMI_SCAN_CONTINUE_ON_ERROR 0x80
1849 /* WMI_SCAN_CLASS_MASK must be the same value as IEEE80211_SCAN_CLASS_MASK */
1850 #define WMI_SCAN_CLASS_MASK 0xFF000000
1853 enum wmi_stop_scan_type {
1854 WMI_SCAN_STOP_ONE = 0x00000000, /* stop by scan_id */
1855 WMI_SCAN_STOP_VDEV_ALL = 0x01000000, /* stop by vdev_id */
1856 WMI_SCAN_STOP_ALL = 0x04000000, /* stop all scans */
1859 struct wmi_stop_scan_cmd {
1866 struct wmi_stop_scan_arg {
1868 enum wmi_stop_scan_type req_type;
1875 struct wmi_scan_chan_list_cmd {
1876 __le32 num_scan_chans;
1877 struct wmi_channel chan_info[0];
1880 struct wmi_scan_chan_list_arg {
1882 struct wmi_channel_arg *channels;
1885 enum wmi_bss_filter {
1886 WMI_BSS_FILTER_NONE = 0, /* no beacons forwarded */
1887 WMI_BSS_FILTER_ALL, /* all beacons forwarded */
1888 WMI_BSS_FILTER_PROFILE, /* only beacons matching profile */
1889 WMI_BSS_FILTER_ALL_BUT_PROFILE, /* all but beacons matching profile */
1890 WMI_BSS_FILTER_CURRENT_BSS, /* only beacons matching current BSS */
1891 WMI_BSS_FILTER_ALL_BUT_BSS, /* all but beacons matching BSS */
1892 WMI_BSS_FILTER_PROBED_SSID, /* beacons matching probed ssid */
1893 WMI_BSS_FILTER_LAST_BSS, /* marker only */
1896 enum wmi_scan_event_type {
1897 WMI_SCAN_EVENT_STARTED = 0x1,
1898 WMI_SCAN_EVENT_COMPLETED = 0x2,
1899 WMI_SCAN_EVENT_BSS_CHANNEL = 0x4,
1900 WMI_SCAN_EVENT_FOREIGN_CHANNEL = 0x8,
1901 WMI_SCAN_EVENT_DEQUEUED = 0x10,
1902 WMI_SCAN_EVENT_PREEMPTED = 0x20, /* possibly by high-prio scan */
1903 WMI_SCAN_EVENT_START_FAILED = 0x40,
1904 WMI_SCAN_EVENT_RESTARTED = 0x80,
1905 WMI_SCAN_EVENT_MAX = 0x8000
1908 enum wmi_scan_completion_reason {
1909 WMI_SCAN_REASON_COMPLETED,
1910 WMI_SCAN_REASON_CANCELLED,
1911 WMI_SCAN_REASON_PREEMPTED,
1912 WMI_SCAN_REASON_TIMEDOUT,
1913 WMI_SCAN_REASON_MAX,
1916 struct wmi_scan_event {
1917 __le32 event_type; /* %WMI_SCAN_EVENT_ */
1918 __le32 reason; /* %WMI_SCAN_REASON_ */
1919 __le32 channel_freq; /* only valid for WMI_SCAN_EVENT_FOREIGN_CHANNEL */
1926 * This defines how much headroom is kept in the
1927 * receive frame between the descriptor and the
1928 * payload, in order for the WMI PHY error and
1929 * management handler to insert header contents.
1933 #define WMI_MGMT_RX_HDR_HEADROOM 52
1936 * This event will be used for sending scan results
1937 * as well as rx mgmt frames to the host. The rx buffer
1938 * will be sent as part of this WMI event. It would be a
1939 * good idea to pass all the fields in the RX status
1940 * descriptor up to the host.
1942 struct wmi_mgmt_rx_hdr_v1 {
1948 __le32 status; /* %WMI_RX_STATUS_ */
1951 struct wmi_mgmt_rx_hdr_v2 {
1952 struct wmi_mgmt_rx_hdr_v1 v1;
1956 struct wmi_mgmt_rx_event_v1 {
1957 struct wmi_mgmt_rx_hdr_v1 hdr;
1961 struct wmi_mgmt_rx_event_v2 {
1962 struct wmi_mgmt_rx_hdr_v2 hdr;
1966 #define WMI_RX_STATUS_OK 0x00
1967 #define WMI_RX_STATUS_ERR_CRC 0x01
1968 #define WMI_RX_STATUS_ERR_DECRYPT 0x08
1969 #define WMI_RX_STATUS_ERR_MIC 0x10
1970 #define WMI_RX_STATUS_ERR_KEY_CACHE_MISS 0x20
1972 #define PHY_ERROR_SPECTRAL_SCAN 0x26
1973 #define PHY_ERROR_FALSE_RADAR_EXT 0x24
1974 #define PHY_ERROR_RADAR 0x05
1976 struct wmi_single_phyerr_rx_hdr {
1978 __le32 tsf_timestamp;
1981 * Current freq1, freq2
1984 * [15:8] : freq1[hi]
1985 * [23:16]: freq2[lo]
1986 * [31:24]: freq2[hi]
1992 * Combined RSSI over all chains and channel width for this PHY error
1994 * [7:0]: RSSI combined
1995 * [15:8]: Channel width (MHz)
1996 * [23:16]: PHY error code
1997 * [24:16]: reserved (future use)
2005 * RSSI on chain 0 through 3
2007 * This is formatted the same as the PPDU_START RX descriptor
2022 * Last calibrated NF value for chain 0 through 3
2026 * + [15:0] - chain 0
2027 * + [31:16] - chain 1
2031 * + [15:0] - chain 2
2032 * + [31:16] - chain 3
2038 /* Length of the frame */
2042 struct wmi_single_phyerr_rx_event {
2043 /* Phy error event header */
2044 struct wmi_single_phyerr_rx_hdr hdr;
2049 struct wmi_comb_phyerr_rx_hdr {
2050 /* Phy error phy error count */
2051 __le32 num_phyerr_events;
2056 struct wmi_comb_phyerr_rx_event {
2057 /* Phy error phy error count */
2058 struct wmi_comb_phyerr_rx_hdr hdr;
2060 * frame buffer - contains multiple payloads in the order:
2061 * header - payload, header - payload...
2062 * (The header is of type: wmi_single_phyerr_rx_hdr)
2067 #define PHYERR_TLV_SIG 0xBB
2068 #define PHYERR_TLV_TAG_SEARCH_FFT_REPORT 0xFB
2069 #define PHYERR_TLV_TAG_RADAR_PULSE_SUMMARY 0xF8
2071 struct phyerr_radar_report {
2072 __le32 reg0; /* RADAR_REPORT_REG0_* */
2073 __le32 reg1; /* REDAR_REPORT_REG1_* */
2076 #define RADAR_REPORT_REG0_PULSE_IS_CHIRP_MASK 0x80000000
2077 #define RADAR_REPORT_REG0_PULSE_IS_CHIRP_LSB 31
2079 #define RADAR_REPORT_REG0_PULSE_IS_MAX_WIDTH_MASK 0x40000000
2080 #define RADAR_REPORT_REG0_PULSE_IS_MAX_WIDTH_LSB 30
2082 #define RADAR_REPORT_REG0_AGC_TOTAL_GAIN_MASK 0x3FF00000
2083 #define RADAR_REPORT_REG0_AGC_TOTAL_GAIN_LSB 20
2085 #define RADAR_REPORT_REG0_PULSE_DELTA_DIFF_MASK 0x000F0000
2086 #define RADAR_REPORT_REG0_PULSE_DELTA_DIFF_LSB 16
2088 #define RADAR_REPORT_REG0_PULSE_DELTA_PEAK_MASK 0x0000FC00
2089 #define RADAR_REPORT_REG0_PULSE_DELTA_PEAK_LSB 10
2091 #define RADAR_REPORT_REG0_PULSE_SIDX_MASK 0x000003FF
2092 #define RADAR_REPORT_REG0_PULSE_SIDX_LSB 0
2094 #define RADAR_REPORT_REG1_PULSE_SRCH_FFT_VALID_MASK 0x80000000
2095 #define RADAR_REPORT_REG1_PULSE_SRCH_FFT_VALID_LSB 31
2097 #define RADAR_REPORT_REG1_PULSE_AGC_MB_GAIN_MASK 0x7F000000
2098 #define RADAR_REPORT_REG1_PULSE_AGC_MB_GAIN_LSB 24
2100 #define RADAR_REPORT_REG1_PULSE_SUBCHAN_MASK_MASK 0x00FF0000
2101 #define RADAR_REPORT_REG1_PULSE_SUBCHAN_MASK_LSB 16
2103 #define RADAR_REPORT_REG1_PULSE_TSF_OFFSET_MASK 0x0000FF00
2104 #define RADAR_REPORT_REG1_PULSE_TSF_OFFSET_LSB 8
2106 #define RADAR_REPORT_REG1_PULSE_DUR_MASK 0x000000FF
2107 #define RADAR_REPORT_REG1_PULSE_DUR_LSB 0
2109 struct phyerr_fft_report {
2110 __le32 reg0; /* SEARCH_FFT_REPORT_REG0_ * */
2111 __le32 reg1; /* SEARCH_FFT_REPORT_REG1_ * */
2114 #define SEARCH_FFT_REPORT_REG0_TOTAL_GAIN_DB_MASK 0xFF800000
2115 #define SEARCH_FFT_REPORT_REG0_TOTAL_GAIN_DB_LSB 23
2117 #define SEARCH_FFT_REPORT_REG0_BASE_PWR_DB_MASK 0x007FC000
2118 #define SEARCH_FFT_REPORT_REG0_BASE_PWR_DB_LSB 14
2120 #define SEARCH_FFT_REPORT_REG0_FFT_CHN_IDX_MASK 0x00003000
2121 #define SEARCH_FFT_REPORT_REG0_FFT_CHN_IDX_LSB 12
2123 #define SEARCH_FFT_REPORT_REG0_PEAK_SIDX_MASK 0x00000FFF
2124 #define SEARCH_FFT_REPORT_REG0_PEAK_SIDX_LSB 0
2126 #define SEARCH_FFT_REPORT_REG1_RELPWR_DB_MASK 0xFC000000
2127 #define SEARCH_FFT_REPORT_REG1_RELPWR_DB_LSB 26
2129 #define SEARCH_FFT_REPORT_REG1_AVGPWR_DB_MASK 0x03FC0000
2130 #define SEARCH_FFT_REPORT_REG1_AVGPWR_DB_LSB 18
2132 #define SEARCH_FFT_REPORT_REG1_PEAK_MAG_MASK 0x0003FF00
2133 #define SEARCH_FFT_REPORT_REG1_PEAK_MAG_LSB 8
2135 #define SEARCH_FFT_REPORT_REG1_NUM_STR_BINS_IB_MASK 0x000000FF
2136 #define SEARCH_FFT_REPORT_REG1_NUM_STR_BINS_IB_LSB 0
2145 #define DFS_RSSI_POSSIBLY_FALSE 50
2146 #define DFS_PEAK_MAG_THOLD_POSSIBLY_FALSE 40
2148 struct wmi_mgmt_tx_hdr {
2150 struct wmi_mac_addr peer_macaddr;
2156 struct wmi_mgmt_tx_cmd {
2157 struct wmi_mgmt_tx_hdr hdr;
2161 struct wmi_echo_event {
2165 struct wmi_echo_cmd {
2170 struct wmi_pdev_set_regdomain_cmd {
2172 __le32 reg_domain_2G;
2173 __le32 reg_domain_5G;
2174 __le32 conformance_test_limit_2G;
2175 __le32 conformance_test_limit_5G;
2178 enum wmi_dfs_region {
2179 /* Uninitialized dfs domain */
2180 WMI_UNINIT_DFS_DOMAIN = 0,
2182 /* FCC3 dfs domain */
2183 WMI_FCC_DFS_DOMAIN = 1,
2185 /* ETSI dfs domain */
2186 WMI_ETSI_DFS_DOMAIN = 2,
2188 /*Japan dfs domain */
2189 WMI_MKK4_DFS_DOMAIN = 3,
2192 struct wmi_pdev_set_regdomain_cmd_10x {
2194 __le32 reg_domain_2G;
2195 __le32 reg_domain_5G;
2196 __le32 conformance_test_limit_2G;
2197 __le32 conformance_test_limit_5G;
2199 /* dfs domain from wmi_dfs_region */
2203 /* Command to set/unset chip in quiet mode */
2204 struct wmi_pdev_set_quiet_cmd {
2208 /* duration in TUs */
2214 /* enable/disable */
2220 * 802.11g protection mode.
2222 enum ath10k_protmode {
2223 ATH10K_PROT_NONE = 0, /* no protection */
2224 ATH10K_PROT_CTSONLY = 1, /* CTS to self */
2225 ATH10K_PROT_RTSCTS = 2, /* RTS-CTS */
2228 enum wmi_rtscts_profile {
2229 WMI_RTSCTS_FOR_NO_RATESERIES = 0,
2230 WMI_RTSCTS_FOR_SECOND_RATESERIES,
2231 WMI_RTSCTS_ACROSS_SW_RETRIES
2234 #define WMI_RTSCTS_ENABLED 1
2235 #define WMI_RTSCTS_SET_MASK 0x0f
2236 #define WMI_RTSCTS_SET_LSB 0
2238 #define WMI_RTSCTS_PROFILE_MASK 0xf0
2239 #define WMI_RTSCTS_PROFILE_LSB 4
2241 enum wmi_beacon_gen_mode {
2242 WMI_BEACON_STAGGERED_MODE = 0,
2243 WMI_BEACON_BURST_MODE = 1
2246 enum wmi_csa_event_ies_present_flag {
2247 WMI_CSA_IE_PRESENT = 0x00000001,
2248 WMI_XCSA_IE_PRESENT = 0x00000002,
2249 WMI_WBW_IE_PRESENT = 0x00000004,
2250 WMI_CSWARP_IE_PRESENT = 0x00000008,
2253 /* wmi CSA receive event from beacon frame */
2254 struct wmi_csa_event {
2257 /* Bit 16-31: DUR */
2258 struct wmi_mac_addr i_addr1;
2259 struct wmi_mac_addr i_addr2;
2264 __le32 ies_present_flag; /* wmi_csa_event_ies_present_flag */
2267 /* the definition of different PDEV parameters */
2268 #define PDEV_DEFAULT_STATS_UPDATE_PERIOD 500
2269 #define VDEV_DEFAULT_STATS_UPDATE_PERIOD 500
2270 #define PEER_DEFAULT_STATS_UPDATE_PERIOD 500
2272 struct wmi_pdev_param_map {
2275 u32 txpower_limit2g;
2276 u32 txpower_limit5g;
2278 u32 beacon_gen_mode;
2280 u32 resmgr_offchan_mode;
2281 u32 protection_mode;
2283 u32 non_agg_sw_retry_th;
2284 u32 agg_sw_retry_th;
2286 u32 ac_aggrsize_scaling;
2288 u32 ltr_ac_latency_be;
2289 u32 ltr_ac_latency_bk;
2290 u32 ltr_ac_latency_vi;
2291 u32 ltr_ac_latency_vo;
2292 u32 ltr_ac_latency_timeout;
2293 u32 ltr_sleep_override;
2294 u32 ltr_rx_override;
2295 u32 ltr_tx_activity_timeout;
2298 u32 pcielp_txbuf_flush;
2299 u32 pcielp_txbuf_watermark;
2300 u32 pcielp_txbuf_tmo_en;
2301 u32 pcielp_txbuf_tmo_value;
2302 u32 pdev_stats_update_period;
2303 u32 vdev_stats_update_period;
2304 u32 peer_stats_update_period;
2305 u32 bcnflt_stats_update_period;
2307 u32 arp_ac_override;
2310 u32 ani_poll_period;
2311 u32 ani_listen_period;
2317 u32 power_gating_sleep;
2318 u32 fast_channel_reset;
2323 #define WMI_PDEV_PARAM_UNSUPPORTED 0
2325 enum wmi_pdev_param {
2327 WMI_PDEV_PARAM_TX_CHAIN_MASK = 0x1,
2329 WMI_PDEV_PARAM_RX_CHAIN_MASK,
2330 /* TX power limit for 2G Radio */
2331 WMI_PDEV_PARAM_TXPOWER_LIMIT2G,
2332 /* TX power limit for 5G Radio */
2333 WMI_PDEV_PARAM_TXPOWER_LIMIT5G,
2334 /* TX power scale */
2335 WMI_PDEV_PARAM_TXPOWER_SCALE,
2336 /* Beacon generation mode . 0: host, 1: target */
2337 WMI_PDEV_PARAM_BEACON_GEN_MODE,
2338 /* Beacon generation mode . 0: staggered 1: bursted */
2339 WMI_PDEV_PARAM_BEACON_TX_MODE,
2341 * Resource manager off chan mode .
2342 * 0: turn off off chan mode. 1: turn on offchan mode
2344 WMI_PDEV_PARAM_RESMGR_OFFCHAN_MODE,
2347 * 0: no protection 1:use CTS-to-self 2: use RTS/CTS
2349 WMI_PDEV_PARAM_PROTECTION_MODE,
2351 * Dynamic bandwidth - 0: disable, 1: enable
2353 * When enabled HW rate control tries different bandwidths when
2354 * retransmitting frames.
2356 WMI_PDEV_PARAM_DYNAMIC_BW,
2357 /* Non aggregrate/ 11g sw retry threshold.0-disable */
2358 WMI_PDEV_PARAM_NON_AGG_SW_RETRY_TH,
2359 /* aggregrate sw retry threshold. 0-disable*/
2360 WMI_PDEV_PARAM_AGG_SW_RETRY_TH,
2361 /* Station kickout threshold (non of consecutive failures).0-disable */
2362 WMI_PDEV_PARAM_STA_KICKOUT_TH,
2363 /* Aggerate size scaling configuration per AC */
2364 WMI_PDEV_PARAM_AC_AGGRSIZE_SCALING,
2366 WMI_PDEV_PARAM_LTR_ENABLE,
2367 /* LTR latency for BE, in us */
2368 WMI_PDEV_PARAM_LTR_AC_LATENCY_BE,
2369 /* LTR latency for BK, in us */
2370 WMI_PDEV_PARAM_LTR_AC_LATENCY_BK,
2371 /* LTR latency for VI, in us */
2372 WMI_PDEV_PARAM_LTR_AC_LATENCY_VI,
2373 /* LTR latency for VO, in us */
2374 WMI_PDEV_PARAM_LTR_AC_LATENCY_VO,
2375 /* LTR AC latency timeout, in ms */
2376 WMI_PDEV_PARAM_LTR_AC_LATENCY_TIMEOUT,
2377 /* LTR platform latency override, in us */
2378 WMI_PDEV_PARAM_LTR_SLEEP_OVERRIDE,
2379 /* LTR-RX override, in us */
2380 WMI_PDEV_PARAM_LTR_RX_OVERRIDE,
2381 /* Tx activity timeout for LTR, in us */
2382 WMI_PDEV_PARAM_LTR_TX_ACTIVITY_TIMEOUT,
2383 /* L1SS state machine enable */
2384 WMI_PDEV_PARAM_L1SS_ENABLE,
2385 /* Deep sleep state machine enable */
2386 WMI_PDEV_PARAM_DSLEEP_ENABLE,
2387 /* RX buffering flush enable */
2388 WMI_PDEV_PARAM_PCIELP_TXBUF_FLUSH,
2389 /* RX buffering matermark */
2390 WMI_PDEV_PARAM_PCIELP_TXBUF_WATERMARK,
2391 /* RX buffering timeout enable */
2392 WMI_PDEV_PARAM_PCIELP_TXBUF_TMO_EN,
2393 /* RX buffering timeout value */
2394 WMI_PDEV_PARAM_PCIELP_TXBUF_TMO_VALUE,
2395 /* pdev level stats update period in ms */
2396 WMI_PDEV_PARAM_PDEV_STATS_UPDATE_PERIOD,
2397 /* vdev level stats update period in ms */
2398 WMI_PDEV_PARAM_VDEV_STATS_UPDATE_PERIOD,
2399 /* peer level stats update period in ms */
2400 WMI_PDEV_PARAM_PEER_STATS_UPDATE_PERIOD,
2401 /* beacon filter status update period */
2402 WMI_PDEV_PARAM_BCNFLT_STATS_UPDATE_PERIOD,
2403 /* QOS Mgmt frame protection MFP/PMF 0: disable, 1: enable */
2404 WMI_PDEV_PARAM_PMF_QOS,
2405 /* Access category on which ARP frames are sent */
2406 WMI_PDEV_PARAM_ARP_AC_OVERRIDE,
2407 /* DCS configuration */
2409 /* Enable/Disable ANI on target */
2410 WMI_PDEV_PARAM_ANI_ENABLE,
2411 /* configure the ANI polling period */
2412 WMI_PDEV_PARAM_ANI_POLL_PERIOD,
2413 /* configure the ANI listening period */
2414 WMI_PDEV_PARAM_ANI_LISTEN_PERIOD,
2415 /* configure OFDM immunity level */
2416 WMI_PDEV_PARAM_ANI_OFDM_LEVEL,
2417 /* configure CCK immunity level */
2418 WMI_PDEV_PARAM_ANI_CCK_LEVEL,
2419 /* Enable/Disable CDD for 1x1 STAs in rate control module */
2420 WMI_PDEV_PARAM_DYNTXCHAIN,
2421 /* Enable/Disable proxy STA */
2422 WMI_PDEV_PARAM_PROXY_STA,
2423 /* Enable/Disable low power state when all VDEVs are inactive/idle. */
2424 WMI_PDEV_PARAM_IDLE_PS_CONFIG,
2425 /* Enable/Disable power gating sleep */
2426 WMI_PDEV_PARAM_POWER_GATING_SLEEP,
2429 enum wmi_10x_pdev_param {
2431 WMI_10X_PDEV_PARAM_TX_CHAIN_MASK = 0x1,
2433 WMI_10X_PDEV_PARAM_RX_CHAIN_MASK,
2434 /* TX power limit for 2G Radio */
2435 WMI_10X_PDEV_PARAM_TXPOWER_LIMIT2G,
2436 /* TX power limit for 5G Radio */
2437 WMI_10X_PDEV_PARAM_TXPOWER_LIMIT5G,
2438 /* TX power scale */
2439 WMI_10X_PDEV_PARAM_TXPOWER_SCALE,
2440 /* Beacon generation mode . 0: host, 1: target */
2441 WMI_10X_PDEV_PARAM_BEACON_GEN_MODE,
2442 /* Beacon generation mode . 0: staggered 1: bursted */
2443 WMI_10X_PDEV_PARAM_BEACON_TX_MODE,
2445 * Resource manager off chan mode .
2446 * 0: turn off off chan mode. 1: turn on offchan mode
2448 WMI_10X_PDEV_PARAM_RESMGR_OFFCHAN_MODE,
2451 * 0: no protection 1:use CTS-to-self 2: use RTS/CTS
2453 WMI_10X_PDEV_PARAM_PROTECTION_MODE,
2454 /* Dynamic bandwidth 0: disable 1: enable */
2455 WMI_10X_PDEV_PARAM_DYNAMIC_BW,
2456 /* Non aggregrate/ 11g sw retry threshold.0-disable */
2457 WMI_10X_PDEV_PARAM_NON_AGG_SW_RETRY_TH,
2458 /* aggregrate sw retry threshold. 0-disable*/
2459 WMI_10X_PDEV_PARAM_AGG_SW_RETRY_TH,
2460 /* Station kickout threshold (non of consecutive failures).0-disable */
2461 WMI_10X_PDEV_PARAM_STA_KICKOUT_TH,
2462 /* Aggerate size scaling configuration per AC */
2463 WMI_10X_PDEV_PARAM_AC_AGGRSIZE_SCALING,
2465 WMI_10X_PDEV_PARAM_LTR_ENABLE,
2466 /* LTR latency for BE, in us */
2467 WMI_10X_PDEV_PARAM_LTR_AC_LATENCY_BE,
2468 /* LTR latency for BK, in us */
2469 WMI_10X_PDEV_PARAM_LTR_AC_LATENCY_BK,
2470 /* LTR latency for VI, in us */
2471 WMI_10X_PDEV_PARAM_LTR_AC_LATENCY_VI,
2472 /* LTR latency for VO, in us */
2473 WMI_10X_PDEV_PARAM_LTR_AC_LATENCY_VO,
2474 /* LTR AC latency timeout, in ms */
2475 WMI_10X_PDEV_PARAM_LTR_AC_LATENCY_TIMEOUT,
2476 /* LTR platform latency override, in us */
2477 WMI_10X_PDEV_PARAM_LTR_SLEEP_OVERRIDE,
2478 /* LTR-RX override, in us */
2479 WMI_10X_PDEV_PARAM_LTR_RX_OVERRIDE,
2480 /* Tx activity timeout for LTR, in us */
2481 WMI_10X_PDEV_PARAM_LTR_TX_ACTIVITY_TIMEOUT,
2482 /* L1SS state machine enable */
2483 WMI_10X_PDEV_PARAM_L1SS_ENABLE,
2484 /* Deep sleep state machine enable */
2485 WMI_10X_PDEV_PARAM_DSLEEP_ENABLE,
2486 /* pdev level stats update period in ms */
2487 WMI_10X_PDEV_PARAM_PDEV_STATS_UPDATE_PERIOD,
2488 /* vdev level stats update period in ms */
2489 WMI_10X_PDEV_PARAM_VDEV_STATS_UPDATE_PERIOD,
2490 /* peer level stats update period in ms */
2491 WMI_10X_PDEV_PARAM_PEER_STATS_UPDATE_PERIOD,
2492 /* beacon filter status update period */
2493 WMI_10X_PDEV_PARAM_BCNFLT_STATS_UPDATE_PERIOD,
2494 /* QOS Mgmt frame protection MFP/PMF 0: disable, 1: enable */
2495 WMI_10X_PDEV_PARAM_PMF_QOS,
2496 /* Access category on which ARP and DHCP frames are sent */
2497 WMI_10X_PDEV_PARAM_ARPDHCP_AC_OVERRIDE,
2498 /* DCS configuration */
2499 WMI_10X_PDEV_PARAM_DCS,
2500 /* Enable/Disable ANI on target */
2501 WMI_10X_PDEV_PARAM_ANI_ENABLE,
2502 /* configure the ANI polling period */
2503 WMI_10X_PDEV_PARAM_ANI_POLL_PERIOD,
2504 /* configure the ANI listening period */
2505 WMI_10X_PDEV_PARAM_ANI_LISTEN_PERIOD,
2506 /* configure OFDM immunity level */
2507 WMI_10X_PDEV_PARAM_ANI_OFDM_LEVEL,
2508 /* configure CCK immunity level */
2509 WMI_10X_PDEV_PARAM_ANI_CCK_LEVEL,
2510 /* Enable/Disable CDD for 1x1 STAs in rate control module */
2511 WMI_10X_PDEV_PARAM_DYNTXCHAIN,
2512 /* Enable/Disable Fast channel reset*/
2513 WMI_10X_PDEV_PARAM_FAST_CHANNEL_RESET,
2514 /* Set Bursting DUR */
2515 WMI_10X_PDEV_PARAM_BURST_DUR,
2516 /* Set Bursting Enable*/
2517 WMI_10X_PDEV_PARAM_BURST_ENABLE,
2520 struct wmi_pdev_set_param_cmd {
2525 struct wmi_pdev_get_tpc_config_cmd {
2530 #define WMI_TPC_RATE_MAX 160
2531 #define WMI_TPC_TX_N_CHAIN 4
2533 enum wmi_tpc_config_event_flag {
2534 WMI_TPC_CONFIG_EVENT_FLAG_TABLE_CDD = 0x1,
2535 WMI_TPC_CONFIG_EVENT_FLAG_TABLE_STBC = 0x2,
2536 WMI_TPC_CONFIG_EVENT_FLAG_TABLE_TXBF = 0x4,
2539 struct wmi_pdev_tpc_config_event {
2543 __le32 twice_antenna_reduction;
2544 __le32 twice_max_rd_power;
2545 s32 twice_antenna_gain;
2548 __le32 num_tx_chain;
2551 s8 max_reg_allow_pow[WMI_TPC_TX_N_CHAIN];
2552 s8 max_reg_allow_pow_agcdd[WMI_TPC_TX_N_CHAIN][WMI_TPC_TX_N_CHAIN];
2553 s8 max_reg_allow_pow_agstbc[WMI_TPC_TX_N_CHAIN][WMI_TPC_TX_N_CHAIN];
2554 s8 max_reg_allow_pow_agtxbf[WMI_TPC_TX_N_CHAIN][WMI_TPC_TX_N_CHAIN];
2555 u8 rates_array[WMI_TPC_RATE_MAX];
2558 /* Transmit power scale factor. */
2560 WMI_TP_SCALE_MAX = 0, /* no scaling (default) */
2561 WMI_TP_SCALE_50 = 1, /* 50% of max (-3 dBm) */
2562 WMI_TP_SCALE_25 = 2, /* 25% of max (-6 dBm) */
2563 WMI_TP_SCALE_12 = 3, /* 12% of max (-9 dBm) */
2564 WMI_TP_SCALE_MIN = 4, /* min, but still on */
2565 WMI_TP_SCALE_SIZE = 5, /* max num of enum */
2568 struct wmi_set_channel_cmd {
2569 /* channel (only frequency and mode info are used) */
2570 struct wmi_channel chan;
2573 struct wmi_pdev_chanlist_update_event {
2574 /* number of channels */
2576 /* array of channels */
2577 struct wmi_channel channel_list[1];
2580 #define WMI_MAX_DEBUG_MESG (sizeof(u32) * 32)
2582 struct wmi_debug_mesg_event {
2583 /* message buffer, NULL terminated */
2584 char bufp[WMI_MAX_DEBUG_MESG];
2589 VDEV_SUBTYPE_P2PDEV = 0,
2591 VDEV_SUBTYPE_P2PCLI,
2598 struct wmi_pdev_set_channel_cmd {
2599 /* idnore power , only use flags , mode and freq */
2600 struct wmi_channel chan;
2603 /* Customize the DSCP (bit) to TID (0-7) mapping for QOS */
2604 #define WMI_DSCP_MAP_MAX (64)
2605 struct wmi_pdev_set_dscp_tid_map_cmd {
2606 /* map indicating DSCP to TID conversion */
2607 __le32 dscp_to_tid_map[WMI_DSCP_MAP_MAX];
2610 enum mcast_bcast_rate_id {
2615 struct mcast_bcast_rate {
2616 enum mcast_bcast_rate_id rate_id;
2620 struct wmi_wmm_params {
2629 struct wmi_pdev_set_wmm_params {
2630 struct wmi_wmm_params ac_be;
2631 struct wmi_wmm_params ac_bk;
2632 struct wmi_wmm_params ac_vi;
2633 struct wmi_wmm_params ac_vo;
2636 struct wmi_wmm_params_arg {
2645 struct wmi_pdev_set_wmm_params_arg {
2646 struct wmi_wmm_params_arg ac_be;
2647 struct wmi_wmm_params_arg ac_bk;
2648 struct wmi_wmm_params_arg ac_vi;
2649 struct wmi_wmm_params_arg ac_vo;
2652 struct wal_dbg_tx_stats {
2653 /* Num HTT cookies queued to dispatch list */
2656 /* Num HTT cookies dispatched */
2657 __le32 comp_delivered;
2659 /* Num MSDU queued to WAL */
2662 /* Num MPDU queue to WAL */
2665 /* Num MSDUs dropped by WMM limit */
2668 /* Num Local frames queued */
2669 __le32 local_enqued;
2671 /* Num Local frames done */
2674 /* Num queued to HW */
2677 /* Num PPDU reaped from HW */
2683 /* Num PPDUs cleaned up in TX abort */
2686 /* Num MPDUs requed by SW */
2687 __le32 mpdus_requed;
2689 /* excessive retries */
2692 /* data hw rate code */
2695 /* Scheduler self triggers */
2696 __le32 self_triggers;
2698 /* frames dropped due to excessive sw retries */
2699 __le32 sw_retry_failure;
2701 /* illegal rate phy errors */
2702 __le32 illgl_rate_phy_err;
2704 /* wal pdev continous xretry */
2705 __le32 pdev_cont_xretry;
2707 /* wal pdev continous xretry */
2708 __le32 pdev_tx_timeout;
2710 /* wal pdev resets */
2713 /* frames dropped due to non-availability of stateless TIDs */
2714 __le32 stateless_tid_alloc_failure;
2716 __le32 phy_underrun;
2718 /* MPDU is more than txop limit */
2722 struct wal_dbg_rx_stats {
2723 /* Cnts any change in ring routing mid-ppdu */
2724 __le32 mid_ppdu_route_change;
2726 /* Total number of statuses processed */
2729 /* Extra frags on rings 0-3 */
2735 /* MSDUs / MPDUs delivered to HTT */
2739 /* MSDUs / MPDUs delivered to local stack */
2743 /* AMSDUs that have more MSDUs than the status ring size */
2744 __le32 oversize_amsdu;
2746 /* Number of PHY errors */
2749 /* Number of PHY errors drops */
2750 __le32 phy_err_drop;
2752 /* Number of mpdu errors - FCS, MIC, ENC etc. */
2756 struct wal_dbg_peer_stats {
2757 /* REMOVE THIS ONCE REAL PEER STAT COUNTERS ARE ADDED */
2761 struct wal_dbg_stats {
2762 struct wal_dbg_tx_stats tx;
2763 struct wal_dbg_rx_stats rx;
2764 struct wal_dbg_peer_stats peer;
2768 WMI_REQUEST_PEER_STAT = 0x01,
2769 WMI_REQUEST_AP_STAT = 0x02
2772 struct wlan_inst_rssi_args {
2773 __le16 cfg_retry_count;
2777 struct wmi_request_stats_cmd {
2782 /* peer MAC address */
2783 struct wmi_mac_addr peer_macaddr;
2785 /* Instantaneous RSSI arguments */
2786 struct wlan_inst_rssi_args inst_rssi_args;
2789 /* Suspend option */
2794 /* suspend and disable all interrupts */
2795 WMI_PDEV_SUSPEND_AND_DISABLE_INTR,
2798 struct wmi_pdev_suspend_cmd {
2799 /* suspend option sent to target */
2803 struct wmi_stats_event {
2804 __le32 stats_id; /* %WMI_REQUEST_ */
2806 * number of pdev stats event structures
2807 * (wmi_pdev_stats) 0 or 1
2809 __le32 num_pdev_stats;
2811 * number of vdev stats event structures
2812 * (wmi_vdev_stats) 0 or max vdevs
2814 __le32 num_vdev_stats;
2816 * number of peer stats event structures
2817 * (wmi_peer_stats) 0 or max peers
2819 __le32 num_peer_stats;
2820 __le32 num_bcnflt_stats;
2823 * num_pdev_stats * size of(struct wmi_pdev_stats)
2824 * num_vdev_stats * size of(struct wmi_vdev_stats)
2825 * num_peer_stats * size of(struct wmi_peer_stats)
2827 * By having a zero sized array, the pointer to data area
2828 * becomes available without increasing the struct size
2835 * TODO: add all PDEV stats here
2837 struct wmi_pdev_stats_old {
2838 __le32 chan_nf; /* Channel noise floor */
2839 __le32 tx_frame_count; /* TX frame count */
2840 __le32 rx_frame_count; /* RX frame count */
2841 __le32 rx_clear_count; /* rx clear count */
2842 __le32 cycle_count; /* cycle count */
2843 __le32 phy_err_count; /* Phy error count */
2844 __le32 chan_tx_pwr; /* channel tx power */
2845 struct wal_dbg_stats wal; /* WAL dbg stats */
2848 struct wmi_pdev_stats_10x {
2849 __le32 chan_nf; /* Channel noise floor */
2850 __le32 tx_frame_count; /* TX frame count */
2851 __le32 rx_frame_count; /* RX frame count */
2852 __le32 rx_clear_count; /* rx clear count */
2853 __le32 cycle_count; /* cycle count */
2854 __le32 phy_err_count; /* Phy error count */
2855 __le32 chan_tx_pwr; /* channel tx power */
2856 struct wal_dbg_stats wal; /* WAL dbg stats */
2862 __le32 mib_int_count;
2867 * TODO: add all VDEV stats here
2869 struct wmi_vdev_stats {
2875 * TODO: add more stats
2877 struct wmi_peer_stats_old {
2878 struct wmi_mac_addr peer_macaddr;
2880 __le32 peer_tx_rate;
2883 struct wmi_peer_stats_10x {
2884 struct wmi_mac_addr peer_macaddr;
2886 __le32 peer_tx_rate;
2887 __le32 peer_rx_rate;
2890 struct wmi_vdev_create_cmd {
2893 __le32 vdev_subtype;
2894 struct wmi_mac_addr vdev_macaddr;
2897 enum wmi_vdev_type {
2898 WMI_VDEV_TYPE_AP = 1,
2899 WMI_VDEV_TYPE_STA = 2,
2900 WMI_VDEV_TYPE_IBSS = 3,
2901 WMI_VDEV_TYPE_MONITOR = 4,
2904 enum wmi_vdev_subtype {
2905 WMI_VDEV_SUBTYPE_NONE = 0,
2906 WMI_VDEV_SUBTYPE_P2P_DEVICE = 1,
2907 WMI_VDEV_SUBTYPE_P2P_CLIENT = 2,
2908 WMI_VDEV_SUBTYPE_P2P_GO = 3,
2911 /* values for vdev_subtype */
2913 /* values for vdev_start_request flags */
2915 * Indicates that AP VDEV uses hidden ssid. only valid for
2917 #define WMI_VDEV_START_HIDDEN_SSID (1<<0)
2919 * Indicates if robust management frame/management frame
2920 * protection is enabled. For GO/AP vdevs, it indicates that
2921 * it may support station/client associations with RMF enabled.
2922 * For STA/client vdevs, it indicates that sta will
2923 * associate with AP with RMF enabled. */
2924 #define WMI_VDEV_START_PMF_ENABLED (1<<1)
2926 struct wmi_p2p_noa_descriptor {
2927 __le32 type_count; /* 255: continuous schedule, 0: reserved */
2928 __le32 duration; /* Absent period duration in micro seconds */
2929 __le32 interval; /* Absent period interval in micro seconds */
2930 __le32 start_time; /* 32 bit tsf time when in starts */
2933 struct wmi_vdev_start_request_cmd {
2935 struct wmi_channel chan;
2936 /* unique id identifying the VDEV, generated by the caller */
2938 /* requestor id identifying the caller module */
2939 __le32 requestor_id;
2940 /* beacon interval from received beacon */
2941 __le32 beacon_interval;
2942 /* DTIM Period from the received beacon */
2946 /* ssid field. Only valid for AP/GO/IBSS/BTAmp VDEV type. */
2947 struct wmi_ssid ssid;
2948 /* beacon/probe reponse xmit rate. Applicable for SoftAP. */
2950 /* beacon/probe reponse xmit power. Applicable for SoftAP. */
2951 __le32 bcn_tx_power;
2952 /* number of p2p NOA descriptor(s) from scan entry */
2953 __le32 num_noa_descriptors;
2955 * Disable H/W ack. This used by WMI_VDEV_RESTART_REQUEST_CMDID.
2956 * During CAC, Our HW shouldn't ack ditected frames
2958 __le32 disable_hw_ack;
2959 /* actual p2p NOA descriptor from scan entry */
2960 struct wmi_p2p_noa_descriptor noa_descriptors[2];
2963 struct wmi_vdev_restart_request_cmd {
2964 struct wmi_vdev_start_request_cmd vdev_start_request_cmd;
2967 struct wmi_vdev_start_request_arg {
2969 struct wmi_channel_arg channel;
2976 bool disable_hw_ack;
2981 struct wmi_vdev_delete_cmd {
2982 /* unique id identifying the VDEV, generated by the caller */
2986 struct wmi_vdev_up_cmd {
2988 __le32 vdev_assoc_id;
2989 struct wmi_mac_addr vdev_bssid;
2992 struct wmi_vdev_stop_cmd {
2996 struct wmi_vdev_down_cmd {
3000 struct wmi_vdev_standby_response_cmd {
3001 /* unique id identifying the VDEV, generated by the caller */
3005 struct wmi_vdev_resume_response_cmd {
3006 /* unique id identifying the VDEV, generated by the caller */
3010 struct wmi_vdev_set_param_cmd {
3016 #define WMI_MAX_KEY_INDEX 3
3017 #define WMI_MAX_KEY_LEN 32
3019 #define WMI_KEY_PAIRWISE 0x00
3020 #define WMI_KEY_GROUP 0x01
3021 #define WMI_KEY_TX_USAGE 0x02 /* default tx key - static wep */
3023 struct wmi_key_seq_counter {
3024 __le32 key_seq_counter_l;
3025 __le32 key_seq_counter_h;
3028 #define WMI_CIPHER_NONE 0x0 /* clear key */
3029 #define WMI_CIPHER_WEP 0x1
3030 #define WMI_CIPHER_TKIP 0x2
3031 #define WMI_CIPHER_AES_OCB 0x3
3032 #define WMI_CIPHER_AES_CCM 0x4
3033 #define WMI_CIPHER_WAPI 0x5
3034 #define WMI_CIPHER_CKIP 0x6
3035 #define WMI_CIPHER_AES_CMAC 0x7
3037 struct wmi_vdev_install_key_cmd {
3039 struct wmi_mac_addr peer_macaddr;
3042 __le32 key_cipher; /* %WMI_CIPHER_ */
3043 struct wmi_key_seq_counter key_rsc_counter;
3044 struct wmi_key_seq_counter key_global_rsc_counter;
3045 struct wmi_key_seq_counter key_tsc_counter;
3046 u8 wpi_key_rsc_counter[16];
3047 u8 wpi_key_tsc_counter[16];
3049 __le32 key_txmic_len;
3050 __le32 key_rxmic_len;
3052 /* contains key followed by tx mic followed by rx mic */
3056 struct wmi_vdev_install_key_arg {
3065 const void *key_data;
3069 * vdev fixed rate format:
3070 * - preamble - b7:b6 - see WMI_RATE_PREMABLE_
3071 * - nss - b5:b4 - ss number (0 mean 1ss)
3072 * - rate_mcs - b3:b0 - as below
3073 * CCK: 0 - 11Mbps, 1 - 5,5Mbps, 2 - 2Mbps, 3 - 1Mbps,
3074 * 4 - 11Mbps (s), 5 - 5,5Mbps (s), 6 - 2Mbps (s)
3075 * OFDM: 0 - 48Mbps, 1 - 24Mbps, 2 - 12Mbps, 3 - 6Mbps,
3076 * 4 - 54Mbps, 5 - 36Mbps, 6 - 18Mbps, 7 - 9Mbps
3080 /* Preamble types to be used with VDEV fixed rate configuration */
3081 enum wmi_rate_preamble {
3082 WMI_RATE_PREAMBLE_OFDM,
3083 WMI_RATE_PREAMBLE_CCK,
3084 WMI_RATE_PREAMBLE_HT,
3085 WMI_RATE_PREAMBLE_VHT,
3088 /* Value to disable fixed rate setting */
3089 #define WMI_FIXED_RATE_NONE (0xff)
3091 struct wmi_vdev_param_map {
3093 u32 fragmentation_threshold;
3094 u32 beacon_interval;
3095 u32 listen_interval;
3101 u32 wmi_vdev_stats_update_period;
3102 u32 wmi_vdev_pwrsave_ageout_time;
3103 u32 wmi_vdev_host_swba_interval;
3105 u32 wmi_vdev_oc_scheduler_air_time_limit;
3108 u32 bmiss_count_max;
3109 u32 bmiss_first_bcnt;
3110 u32 bmiss_final_bcnt;
3114 u32 disable_htprotection;
3115 u32 sta_quickkickout;
3117 u32 protection_mode;
3126 u32 bcast_data_rate;
3127 u32 mcast_data_rate;
3130 u32 unknown_dest_indicate;
3131 u32 ap_keepalive_min_idle_inactive_time_secs;
3132 u32 ap_keepalive_max_idle_inactive_time_secs;
3133 u32 ap_keepalive_max_unresponsive_time_secs;
3134 u32 ap_enable_nawds;
3135 u32 mcast2ucast_set;
3138 u32 packet_powersave;
3141 u32 ap_detect_out_of_sync_sleeping_sta_time_secs;
3144 #define WMI_VDEV_PARAM_UNSUPPORTED 0
3146 /* the definition of different VDEV parameters */
3147 enum wmi_vdev_param {
3149 WMI_VDEV_PARAM_RTS_THRESHOLD = 0x1,
3150 /* Fragmentation threshold */
3151 WMI_VDEV_PARAM_FRAGMENTATION_THRESHOLD,
3152 /* beacon interval in TUs */
3153 WMI_VDEV_PARAM_BEACON_INTERVAL,
3154 /* Listen interval in TUs */
3155 WMI_VDEV_PARAM_LISTEN_INTERVAL,
3156 /* muticast rate in Mbps */
3157 WMI_VDEV_PARAM_MULTICAST_RATE,
3158 /* management frame rate in Mbps */
3159 WMI_VDEV_PARAM_MGMT_TX_RATE,
3160 /* slot time (long vs short) */
3161 WMI_VDEV_PARAM_SLOT_TIME,
3162 /* preamble (long vs short) */
3163 WMI_VDEV_PARAM_PREAMBLE,
3164 /* SWBA time (time before tbtt in msec) */
3165 WMI_VDEV_PARAM_SWBA_TIME,
3166 /* time period for updating VDEV stats */
3167 WMI_VDEV_STATS_UPDATE_PERIOD,
3168 /* age out time in msec for frames queued for station in power save */
3169 WMI_VDEV_PWRSAVE_AGEOUT_TIME,
3171 * Host SWBA interval (time in msec before tbtt for SWBA event
3174 WMI_VDEV_HOST_SWBA_INTERVAL,
3175 /* DTIM period (specified in units of num beacon intervals) */
3176 WMI_VDEV_PARAM_DTIM_PERIOD,
3178 * scheduler air time limit for this VDEV. used by off chan
3181 WMI_VDEV_OC_SCHEDULER_AIR_TIME_LIMIT,
3182 /* enable/dsiable WDS for this VDEV */
3185 WMI_VDEV_PARAM_ATIM_WINDOW,
3187 WMI_VDEV_PARAM_BMISS_COUNT_MAX,
3188 /* BMISS first time */
3189 WMI_VDEV_PARAM_BMISS_FIRST_BCNT,
3190 /* BMISS final time */
3191 WMI_VDEV_PARAM_BMISS_FINAL_BCNT,
3192 /* WMM enables/disabled */
3193 WMI_VDEV_PARAM_FEATURE_WMM,
3195 WMI_VDEV_PARAM_CHWIDTH,
3196 /* Channel Offset */
3197 WMI_VDEV_PARAM_CHEXTOFFSET,
3198 /* Disable HT Protection */
3199 WMI_VDEV_PARAM_DISABLE_HTPROTECTION,
3200 /* Quick STA Kickout */
3201 WMI_VDEV_PARAM_STA_QUICKKICKOUT,
3202 /* Rate to be used with Management frames */
3203 WMI_VDEV_PARAM_MGMT_RATE,
3204 /* Protection Mode */
3205 WMI_VDEV_PARAM_PROTECTION_MODE,
3206 /* Fixed rate setting */
3207 WMI_VDEV_PARAM_FIXED_RATE,
3208 /* Short GI Enable/Disable */
3211 WMI_VDEV_PARAM_LDPC,
3212 /* Enable Tx STBC */
3213 WMI_VDEV_PARAM_TX_STBC,
3214 /* Enable Rx STBC */
3215 WMI_VDEV_PARAM_RX_STBC,
3216 /* Intra BSS forwarding */
3217 WMI_VDEV_PARAM_INTRA_BSS_FWD,
3218 /* Setting Default xmit key for Vdev */
3219 WMI_VDEV_PARAM_DEF_KEYID,
3222 /* Set the custom rate for the broadcast data frames */
3223 WMI_VDEV_PARAM_BCAST_DATA_RATE,
3224 /* Set the custom rate (rate-code) for multicast data frames */
3225 WMI_VDEV_PARAM_MCAST_DATA_RATE,
3226 /* Tx multicast packet indicate Enable/Disable */
3227 WMI_VDEV_PARAM_MCAST_INDICATE,
3228 /* Tx DHCP packet indicate Enable/Disable */
3229 WMI_VDEV_PARAM_DHCP_INDICATE,
3230 /* Enable host inspection of Tx unicast packet to unknown destination */
3231 WMI_VDEV_PARAM_UNKNOWN_DEST_INDICATE,
3233 /* The minimum amount of time AP begins to consider STA inactive */
3234 WMI_VDEV_PARAM_AP_KEEPALIVE_MIN_IDLE_INACTIVE_TIME_SECS,
3237 * An associated STA is considered inactive when there is no recent
3238 * TX/RX activity and no downlink frames are buffered for it. Once a
3239 * STA exceeds the maximum idle inactive time, the AP will send an
3240 * 802.11 data-null as a keep alive to verify the STA is still
3241 * associated. If the STA does ACK the data-null, or if the data-null
3242 * is buffered and the STA does not retrieve it, the STA will be
3243 * considered unresponsive
3244 * (see WMI_VDEV_AP_KEEPALIVE_MAX_UNRESPONSIVE_TIME_SECS).
3246 WMI_VDEV_PARAM_AP_KEEPALIVE_MAX_IDLE_INACTIVE_TIME_SECS,
3249 * An associated STA is considered unresponsive if there is no recent
3250 * TX/RX activity and downlink frames are buffered for it. Once a STA
3251 * exceeds the maximum unresponsive time, the AP will send a
3252 * WMI_STA_KICKOUT event to the host so the STA can be deleted. */
3253 WMI_VDEV_PARAM_AP_KEEPALIVE_MAX_UNRESPONSIVE_TIME_SECS,
3255 /* Enable NAWDS : MCAST INSPECT Enable, NAWDS Flag set */
3256 WMI_VDEV_PARAM_AP_ENABLE_NAWDS,
3257 /* Enable/Disable RTS-CTS */
3258 WMI_VDEV_PARAM_ENABLE_RTSCTS,
3259 /* Enable TXBFee/er */
3260 WMI_VDEV_PARAM_TXBF,
3262 /* Set packet power save */
3263 WMI_VDEV_PARAM_PACKET_POWERSAVE,
3266 * Drops un-encrypted packets if eceived in an encrypted connection
3267 * otherwise forwards to host.
3269 WMI_VDEV_PARAM_DROP_UNENCRY,
3272 * Set the encapsulation type for frames.
3274 WMI_VDEV_PARAM_TX_ENCAP_TYPE,
3277 /* the definition of different VDEV parameters */
3278 enum wmi_10x_vdev_param {
3280 WMI_10X_VDEV_PARAM_RTS_THRESHOLD = 0x1,
3281 /* Fragmentation threshold */
3282 WMI_10X_VDEV_PARAM_FRAGMENTATION_THRESHOLD,
3283 /* beacon interval in TUs */
3284 WMI_10X_VDEV_PARAM_BEACON_INTERVAL,
3285 /* Listen interval in TUs */
3286 WMI_10X_VDEV_PARAM_LISTEN_INTERVAL,
3287 /* muticast rate in Mbps */
3288 WMI_10X_VDEV_PARAM_MULTICAST_RATE,
3289 /* management frame rate in Mbps */
3290 WMI_10X_VDEV_PARAM_MGMT_TX_RATE,
3291 /* slot time (long vs short) */
3292 WMI_10X_VDEV_PARAM_SLOT_TIME,
3293 /* preamble (long vs short) */
3294 WMI_10X_VDEV_PARAM_PREAMBLE,
3295 /* SWBA time (time before tbtt in msec) */
3296 WMI_10X_VDEV_PARAM_SWBA_TIME,
3297 /* time period for updating VDEV stats */
3298 WMI_10X_VDEV_STATS_UPDATE_PERIOD,
3299 /* age out time in msec for frames queued for station in power save */
3300 WMI_10X_VDEV_PWRSAVE_AGEOUT_TIME,
3302 * Host SWBA interval (time in msec before tbtt for SWBA event
3305 WMI_10X_VDEV_HOST_SWBA_INTERVAL,
3306 /* DTIM period (specified in units of num beacon intervals) */
3307 WMI_10X_VDEV_PARAM_DTIM_PERIOD,
3309 * scheduler air time limit for this VDEV. used by off chan
3312 WMI_10X_VDEV_OC_SCHEDULER_AIR_TIME_LIMIT,
3313 /* enable/dsiable WDS for this VDEV */
3314 WMI_10X_VDEV_PARAM_WDS,
3316 WMI_10X_VDEV_PARAM_ATIM_WINDOW,
3318 WMI_10X_VDEV_PARAM_BMISS_COUNT_MAX,
3319 /* WMM enables/disabled */
3320 WMI_10X_VDEV_PARAM_FEATURE_WMM,
3322 WMI_10X_VDEV_PARAM_CHWIDTH,
3323 /* Channel Offset */
3324 WMI_10X_VDEV_PARAM_CHEXTOFFSET,
3325 /* Disable HT Protection */
3326 WMI_10X_VDEV_PARAM_DISABLE_HTPROTECTION,
3327 /* Quick STA Kickout */
3328 WMI_10X_VDEV_PARAM_STA_QUICKKICKOUT,
3329 /* Rate to be used with Management frames */
3330 WMI_10X_VDEV_PARAM_MGMT_RATE,
3331 /* Protection Mode */
3332 WMI_10X_VDEV_PARAM_PROTECTION_MODE,
3333 /* Fixed rate setting */
3334 WMI_10X_VDEV_PARAM_FIXED_RATE,
3335 /* Short GI Enable/Disable */
3336 WMI_10X_VDEV_PARAM_SGI,
3338 WMI_10X_VDEV_PARAM_LDPC,
3339 /* Enable Tx STBC */
3340 WMI_10X_VDEV_PARAM_TX_STBC,
3341 /* Enable Rx STBC */
3342 WMI_10X_VDEV_PARAM_RX_STBC,
3343 /* Intra BSS forwarding */
3344 WMI_10X_VDEV_PARAM_INTRA_BSS_FWD,
3345 /* Setting Default xmit key for Vdev */
3346 WMI_10X_VDEV_PARAM_DEF_KEYID,
3348 WMI_10X_VDEV_PARAM_NSS,
3349 /* Set the custom rate for the broadcast data frames */
3350 WMI_10X_VDEV_PARAM_BCAST_DATA_RATE,
3351 /* Set the custom rate (rate-code) for multicast data frames */
3352 WMI_10X_VDEV_PARAM_MCAST_DATA_RATE,
3353 /* Tx multicast packet indicate Enable/Disable */
3354 WMI_10X_VDEV_PARAM_MCAST_INDICATE,
3355 /* Tx DHCP packet indicate Enable/Disable */
3356 WMI_10X_VDEV_PARAM_DHCP_INDICATE,
3357 /* Enable host inspection of Tx unicast packet to unknown destination */
3358 WMI_10X_VDEV_PARAM_UNKNOWN_DEST_INDICATE,
3360 /* The minimum amount of time AP begins to consider STA inactive */
3361 WMI_10X_VDEV_PARAM_AP_KEEPALIVE_MIN_IDLE_INACTIVE_TIME_SECS,
3364 * An associated STA is considered inactive when there is no recent
3365 * TX/RX activity and no downlink frames are buffered for it. Once a
3366 * STA exceeds the maximum idle inactive time, the AP will send an
3367 * 802.11 data-null as a keep alive to verify the STA is still
3368 * associated. If the STA does ACK the data-null, or if the data-null
3369 * is buffered and the STA does not retrieve it, the STA will be
3370 * considered unresponsive
3371 * (see WMI_10X_VDEV_AP_KEEPALIVE_MAX_UNRESPONSIVE_TIME_SECS).
3373 WMI_10X_VDEV_PARAM_AP_KEEPALIVE_MAX_IDLE_INACTIVE_TIME_SECS,
3376 * An associated STA is considered unresponsive if there is no recent
3377 * TX/RX activity and downlink frames are buffered for it. Once a STA
3378 * exceeds the maximum unresponsive time, the AP will send a
3379 * WMI_10X_STA_KICKOUT event to the host so the STA can be deleted. */
3380 WMI_10X_VDEV_PARAM_AP_KEEPALIVE_MAX_UNRESPONSIVE_TIME_SECS,
3382 /* Enable NAWDS : MCAST INSPECT Enable, NAWDS Flag set */
3383 WMI_10X_VDEV_PARAM_AP_ENABLE_NAWDS,
3385 WMI_10X_VDEV_PARAM_MCAST2UCAST_SET,
3386 /* Enable/Disable RTS-CTS */
3387 WMI_10X_VDEV_PARAM_ENABLE_RTSCTS,
3389 WMI_10X_VDEV_PARAM_AP_DETECT_OUT_OF_SYNC_SLEEPING_STA_TIME_SECS,
3392 /* slot time long */
3393 #define WMI_VDEV_SLOT_TIME_LONG 0x1
3394 /* slot time short */
3395 #define WMI_VDEV_SLOT_TIME_SHORT 0x2
3397 #define WMI_VDEV_PREAMBLE_LONG 0x1
3398 /* preablbe short */
3399 #define WMI_VDEV_PREAMBLE_SHORT 0x2
3401 enum wmi_start_event_param {
3402 WMI_VDEV_RESP_START_EVENT = 0,
3403 WMI_VDEV_RESP_RESTART_EVENT,
3406 struct wmi_vdev_start_response_event {
3409 __le32 resp_type; /* %WMI_VDEV_RESP_ */
3413 struct wmi_vdev_standby_req_event {
3414 /* unique id identifying the VDEV, generated by the caller */
3418 struct wmi_vdev_resume_req_event {
3419 /* unique id identifying the VDEV, generated by the caller */
3423 struct wmi_vdev_stopped_event {
3424 /* unique id identifying the VDEV, generated by the caller */
3429 * common structure used for simple events
3430 * (stopped, resume_req, standby response)
3432 struct wmi_vdev_simple_event {
3433 /* unique id identifying the VDEV, generated by the caller */
3437 /* VDEV start response status codes */
3438 /* VDEV succesfully started */
3439 #define WMI_INIFIED_VDEV_START_RESPONSE_STATUS_SUCCESS 0x0
3441 /* requested VDEV not found */
3442 #define WMI_INIFIED_VDEV_START_RESPONSE_INVALID_VDEVID 0x1
3444 /* unsupported VDEV combination */
3445 #define WMI_INIFIED_VDEV_START_RESPONSE_NOT_SUPPORTED 0x2
3447 /* Beacon processing related command and event structures */
3448 struct wmi_bcn_tx_hdr {
3455 struct wmi_bcn_tx_cmd {
3456 struct wmi_bcn_tx_hdr hdr;
3460 struct wmi_bcn_tx_arg {
3468 enum wmi_bcn_tx_ref_flags {
3469 WMI_BCN_TX_REF_FLAG_DTIM_ZERO = 0x1,
3470 WMI_BCN_TX_REF_FLAG_DELIVER_CAB = 0x2,
3473 struct wmi_bcn_tx_ref_cmd {
3476 /* physical address of the frame - dma pointer */
3478 /* id for host to track */
3480 /* frame ctrl to setup PPDU desc */
3481 __le32 frame_control;
3482 /* to control CABQ traffic: WMI_BCN_TX_REF_FLAG_ */
3487 #define WMI_BCN_FILTER_ALL 0 /* Filter all beacons */
3488 #define WMI_BCN_FILTER_NONE 1 /* Pass all beacons */
3489 #define WMI_BCN_FILTER_RSSI 2 /* Pass Beacons RSSI >= RSSI threshold */
3490 #define WMI_BCN_FILTER_BSSID 3 /* Pass Beacons with matching BSSID */
3491 #define WMI_BCN_FILTER_SSID 4 /* Pass Beacons with matching SSID */
3493 struct wmi_bcn_filter_rx_cmd {
3495 __le32 bcn_filter_id;
3496 /* Filter type - wmi_bcn_filter */
3499 __le32 bcn_filter_len;
3500 /* Filter info (threshold, BSSID, RSSI) */
3504 /* Capabilities and IEs to be passed to firmware */
3505 struct wmi_bcn_prb_info {
3510 /* Advanced capabilities */
3511 /* HT capabilities */
3521 struct wmi_bcn_tmpl_cmd {
3522 /* unique id identifying the VDEV, generated by the caller */
3524 /* TIM IE offset from the beginning of the template. */
3525 __le32 tim_ie_offset;
3526 /* beacon probe capabilities and IEs */
3527 struct wmi_bcn_prb_info bcn_prb_info;
3528 /* beacon buffer length */
3530 /* variable length data */
3534 struct wmi_prb_tmpl_cmd {
3535 /* unique id identifying the VDEV, generated by the caller */
3537 /* beacon probe capabilities and IEs */
3538 struct wmi_bcn_prb_info bcn_prb_info;
3539 /* beacon buffer length */
3541 /* Variable length data */
3545 enum wmi_sta_ps_mode {
3546 /* enable power save for the given STA VDEV */
3547 WMI_STA_PS_MODE_DISABLED = 0,
3548 /* disable power save for a given STA VDEV */
3549 WMI_STA_PS_MODE_ENABLED = 1,
3552 struct wmi_sta_powersave_mode_cmd {
3553 /* unique id identifying the VDEV, generated by the caller */
3558 * (see enum wmi_sta_ps_mode)
3563 enum wmi_csa_offload_en {
3564 WMI_CSA_OFFLOAD_DISABLE = 0,
3565 WMI_CSA_OFFLOAD_ENABLE = 1,
3568 struct wmi_csa_offload_enable_cmd {
3570 __le32 csa_offload_enable;
3573 struct wmi_csa_offload_chanswitch_cmd {
3575 struct wmi_channel chan;
3579 * This parameter controls the policy for retrieving frames from AP while the
3580 * STA is in sleep state.
3582 * Only takes affect if the sta_ps_mode is enabled
3584 enum wmi_sta_ps_param_rx_wake_policy {
3586 * Wake up when ever there is an RX activity on the VDEV. In this mode
3587 * the Power save SM(state machine) will come out of sleep by either
3588 * sending null frame (or) a data frame (with PS==0) in response to TIM
3589 * bit set in the received beacon frame from AP.
3591 WMI_STA_PS_RX_WAKE_POLICY_WAKE = 0,
3594 * Here the power save state machine will not wakeup in response to TIM
3595 * bit, instead it will send a PSPOLL (or) UASPD trigger based on UAPSD
3596 * configuration setup by WMISET_PS_SET_UAPSD WMI command. When all
3597 * access categories are delivery-enabled, the station will send a
3598 * UAPSD trigger frame, otherwise it will send a PS-Poll.
3600 WMI_STA_PS_RX_WAKE_POLICY_POLL_UAPSD = 1,
3604 * Number of tx frames/beacon that cause the power save SM to wake up.
3606 * Value 1 causes the SM to wake up for every TX. Value 0 has a special
3607 * meaning, It will cause the SM to never wake up. This is useful if you want
3608 * to keep the system to sleep all the time for some kind of test mode . host
3609 * can change this parameter any time. It will affect at the next tx frame.
3611 enum wmi_sta_ps_param_tx_wake_threshold {
3612 WMI_STA_PS_TX_WAKE_THRESHOLD_NEVER = 0,
3613 WMI_STA_PS_TX_WAKE_THRESHOLD_ALWAYS = 1,
3616 * Values greater than one indicate that many TX attempts per beacon
3617 * interval before the STA will wake up
3622 * The maximum number of PS-Poll frames the FW will send in response to
3623 * traffic advertised in TIM before waking up (by sending a null frame with PS
3624 * = 0). Value 0 has a special meaning: there is no maximum count and the FW
3625 * will send as many PS-Poll as are necessary to retrieve buffered BU. This
3626 * parameter is used when the RX wake policy is
3627 * WMI_STA_PS_RX_WAKE_POLICY_POLL_UAPSD and ignored when the RX wake
3628 * policy is WMI_STA_PS_RX_WAKE_POLICY_WAKE.
3630 enum wmi_sta_ps_param_pspoll_count {
3631 WMI_STA_PS_PSPOLL_COUNT_NO_MAX = 0,
3633 * Values greater than 0 indicate the maximum numer of PS-Poll frames
3634 * FW will send before waking up.
3639 * This will include the delivery and trigger enabled state for every AC.
3640 * This is the negotiated state with AP. The host MLME needs to set this based
3641 * on AP capability and the state Set in the association request by the
3642 * station MLME.Lower 8 bits of the value specify the UAPSD configuration.
3644 #define WMI_UAPSD_AC_TYPE_DELI 0
3645 #define WMI_UAPSD_AC_TYPE_TRIG 1
3647 #define WMI_UAPSD_AC_BIT_MASK(ac, type) \
3648 ((type == WMI_UAPSD_AC_TYPE_DELI) ? (1<<(ac<<1)) : (1<<((ac<<1)+1)))
3650 enum wmi_sta_ps_param_uapsd {
3651 WMI_STA_PS_UAPSD_AC0_DELIVERY_EN = (1 << 0),
3652 WMI_STA_PS_UAPSD_AC0_TRIGGER_EN = (1 << 1),
3653 WMI_STA_PS_UAPSD_AC1_DELIVERY_EN = (1 << 2),
3654 WMI_STA_PS_UAPSD_AC1_TRIGGER_EN = (1 << 3),
3655 WMI_STA_PS_UAPSD_AC2_DELIVERY_EN = (1 << 4),
3656 WMI_STA_PS_UAPSD_AC2_TRIGGER_EN = (1 << 5),
3657 WMI_STA_PS_UAPSD_AC3_DELIVERY_EN = (1 << 6),
3658 WMI_STA_PS_UAPSD_AC3_TRIGGER_EN = (1 << 7),
3661 enum wmi_sta_powersave_param {
3663 * Controls how frames are retrievd from AP while STA is sleeping
3665 * (see enum wmi_sta_ps_param_rx_wake_policy)
3667 WMI_STA_PS_PARAM_RX_WAKE_POLICY = 0,
3670 * The STA will go active after this many TX
3672 * (see enum wmi_sta_ps_param_tx_wake_threshold)
3674 WMI_STA_PS_PARAM_TX_WAKE_THRESHOLD = 1,
3677 * Number of PS-Poll to send before STA wakes up
3679 * (see enum wmi_sta_ps_param_pspoll_count)
3682 WMI_STA_PS_PARAM_PSPOLL_COUNT = 2,
3685 * TX/RX inactivity time in msec before going to sleep.
3687 * The power save SM will monitor tx/rx activity on the VDEV, if no
3688 * activity for the specified msec of the parameter the Power save
3689 * SM will go to sleep.
3691 WMI_STA_PS_PARAM_INACTIVITY_TIME = 3,
3694 * Set uapsd configuration.
3696 * (see enum wmi_sta_ps_param_uapsd)
3698 WMI_STA_PS_PARAM_UAPSD = 4,
3701 struct wmi_sta_powersave_param_cmd {
3703 __le32 param_id; /* %WMI_STA_PS_PARAM_ */
3707 /* No MIMO power save */
3708 #define WMI_STA_MIMO_PS_MODE_DISABLE
3709 /* mimo powersave mode static*/
3710 #define WMI_STA_MIMO_PS_MODE_STATIC
3711 /* mimo powersave mode dynamic */
3712 #define WMI_STA_MIMO_PS_MODE_DYNAMIC
3714 struct wmi_sta_mimo_ps_mode_cmd {
3715 /* unique id identifying the VDEV, generated by the caller */
3717 /* mimo powersave mode as defined above */
3718 __le32 mimo_pwrsave_mode;
3721 /* U-APSD configuration of peer station from (re)assoc request and TSPECs */
3722 enum wmi_ap_ps_param_uapsd {
3723 WMI_AP_PS_UAPSD_AC0_DELIVERY_EN = (1 << 0),
3724 WMI_AP_PS_UAPSD_AC0_TRIGGER_EN = (1 << 1),
3725 WMI_AP_PS_UAPSD_AC1_DELIVERY_EN = (1 << 2),
3726 WMI_AP_PS_UAPSD_AC1_TRIGGER_EN = (1 << 3),
3727 WMI_AP_PS_UAPSD_AC2_DELIVERY_EN = (1 << 4),
3728 WMI_AP_PS_UAPSD_AC2_TRIGGER_EN = (1 << 5),
3729 WMI_AP_PS_UAPSD_AC3_DELIVERY_EN = (1 << 6),
3730 WMI_AP_PS_UAPSD_AC3_TRIGGER_EN = (1 << 7),
3733 /* U-APSD maximum service period of peer station */
3734 enum wmi_ap_ps_peer_param_max_sp {
3735 WMI_AP_PS_PEER_PARAM_MAX_SP_UNLIMITED = 0,
3736 WMI_AP_PS_PEER_PARAM_MAX_SP_2 = 1,
3737 WMI_AP_PS_PEER_PARAM_MAX_SP_4 = 2,
3738 WMI_AP_PS_PEER_PARAM_MAX_SP_6 = 3,
3739 MAX_WMI_AP_PS_PEER_PARAM_MAX_SP,
3743 * AP power save parameter
3744 * Set a power save specific parameter for a peer station
3746 enum wmi_ap_ps_peer_param {
3747 /* Set uapsd configuration for a given peer.
3749 * Include the delivery and trigger enabled state for every AC.
3750 * The host MLME needs to set this based on AP capability and stations
3751 * request Set in the association request received from the station.
3753 * Lower 8 bits of the value specify the UAPSD configuration.
3755 * (see enum wmi_ap_ps_param_uapsd)
3756 * The default value is 0.
3758 WMI_AP_PS_PEER_PARAM_UAPSD = 0,
3761 * Set the service period for a UAPSD capable station
3763 * The service period from wme ie in the (re)assoc request frame.
3765 * (see enum wmi_ap_ps_peer_param_max_sp)
3767 WMI_AP_PS_PEER_PARAM_MAX_SP = 1,
3769 /* Time in seconds for aging out buffered frames for STA in PS */
3770 WMI_AP_PS_PEER_PARAM_AGEOUT_TIME = 2,
3773 struct wmi_ap_ps_peer_cmd {
3774 /* unique id identifying the VDEV, generated by the caller */
3777 /* peer MAC address */
3778 struct wmi_mac_addr peer_macaddr;
3780 /* AP powersave param (see enum wmi_ap_ps_peer_param) */
3783 /* AP powersave param value */
3787 /* 128 clients = 4 words */
3788 #define WMI_TIM_BITMAP_ARRAY_SIZE 4
3790 struct wmi_tim_info {
3793 __le32 tim_bitmap[WMI_TIM_BITMAP_ARRAY_SIZE];
3795 __le32 tim_num_ps_pending;
3798 /* Maximum number of NOA Descriptors supported */
3799 #define WMI_P2P_MAX_NOA_DESCRIPTORS 4
3800 #define WMI_P2P_OPPPS_ENABLE_BIT BIT(0)
3801 #define WMI_P2P_OPPPS_CTWINDOW_OFFSET 1
3802 #define WMI_P2P_NOA_CHANGED_BIT BIT(0)
3804 struct wmi_p2p_noa_info {
3805 /* Bit 0 - Flag to indicate an update in NOA schedule
3806 Bits 7-1 - Reserved */
3810 /* Bit 0 - Opp PS state of the AP
3811 Bits 1-7 - Ctwindow in TUs */
3813 /* Number of NOA descriptors */
3816 struct wmi_p2p_noa_descriptor descriptors[WMI_P2P_MAX_NOA_DESCRIPTORS];
3819 struct wmi_bcn_info {
3820 struct wmi_tim_info tim_info;
3821 struct wmi_p2p_noa_info p2p_noa_info;
3824 struct wmi_host_swba_event {
3826 struct wmi_bcn_info bcn_info[1];
3829 #define WMI_MAX_AP_VDEV 16
3831 struct wmi_tbtt_offset_event {
3833 __le32 tbttoffset_list[WMI_MAX_AP_VDEV];
3837 struct wmi_peer_create_cmd {
3839 struct wmi_mac_addr peer_macaddr;
3842 struct wmi_peer_delete_cmd {
3844 struct wmi_mac_addr peer_macaddr;
3847 struct wmi_peer_flush_tids_cmd {
3849 struct wmi_mac_addr peer_macaddr;
3850 __le32 peer_tid_bitmap;
3853 struct wmi_fixed_rate {
3855 * rate mode . 0: disable fixed rate (auto rate)
3856 * 1: legacy (non 11n) rate specified as ieee rate 2*Mbps
3857 * 2: ht20 11n rate specified as mcs index
3858 * 3: ht40 11n rate specified as mcs index
3862 * 4 rate values for 4 rate series. series 0 is stored in byte 0 (LSB)
3863 * and series 3 is stored at byte 3 (MSB)
3867 * 4 retry counts for 4 rate series. retry count for rate 0 is stored
3868 * in byte 0 (LSB) and retry count for rate 3 is stored at byte 3
3871 __le32 rate_retries;
3874 struct wmi_peer_fixed_rate_cmd {
3875 /* unique id identifying the VDEV, generated by the caller */
3877 /* peer MAC address */
3878 struct wmi_mac_addr peer_macaddr;
3880 struct wmi_fixed_rate peer_fixed_rate;
3883 #define WMI_MGMT_TID 17
3885 struct wmi_addba_clear_resp_cmd {
3886 /* unique id identifying the VDEV, generated by the caller */
3888 /* peer MAC address */
3889 struct wmi_mac_addr peer_macaddr;
3892 struct wmi_addba_send_cmd {
3893 /* unique id identifying the VDEV, generated by the caller */
3895 /* peer MAC address */
3896 struct wmi_mac_addr peer_macaddr;
3899 /* Buffer/Window size*/
3903 struct wmi_delba_send_cmd {
3904 /* unique id identifying the VDEV, generated by the caller */
3906 /* peer MAC address */
3907 struct wmi_mac_addr peer_macaddr;
3916 struct wmi_addba_setresponse_cmd {
3917 /* unique id identifying the vdev, generated by the caller */
3919 /* peer mac address */
3920 struct wmi_mac_addr peer_macaddr;
3927 struct wmi_send_singleamsdu_cmd {
3928 /* unique id identifying the vdev, generated by the caller */
3930 /* peer mac address */
3931 struct wmi_mac_addr peer_macaddr;
3936 enum wmi_peer_smps_state {
3937 WMI_PEER_SMPS_PS_NONE = 0x0,
3938 WMI_PEER_SMPS_STATIC = 0x1,
3939 WMI_PEER_SMPS_DYNAMIC = 0x2
3942 enum wmi_peer_chwidth {
3943 WMI_PEER_CHWIDTH_20MHZ = 0,
3944 WMI_PEER_CHWIDTH_40MHZ = 1,
3945 WMI_PEER_CHWIDTH_80MHZ = 2,
3948 enum wmi_peer_param {
3949 WMI_PEER_SMPS_STATE = 0x1, /* see %wmi_peer_smps_state */
3950 WMI_PEER_AMPDU = 0x2,
3951 WMI_PEER_AUTHORIZE = 0x3,
3952 WMI_PEER_CHAN_WIDTH = 0x4,
3954 WMI_PEER_USE_4ADDR = 0x6
3957 struct wmi_peer_set_param_cmd {
3959 struct wmi_mac_addr peer_macaddr;
3964 #define MAX_SUPPORTED_RATES 128
3966 struct wmi_rate_set {
3967 /* total number of rates */
3970 * rates (each 8bit value) packed into a 32 bit word.
3971 * the rates are filled from least significant byte to most
3974 __le32 rates[(MAX_SUPPORTED_RATES/4)+1];
3977 struct wmi_rate_set_arg {
3978 unsigned int num_rates;
3979 u8 rates[MAX_SUPPORTED_RATES];
3983 * NOTE: It would bea good idea to represent the Tx MCS
3984 * info in one word and Rx in another word. This is split
3985 * into multiple words for convenience
3987 struct wmi_vht_rate_set {
3988 __le32 rx_max_rate; /* Max Rx data rate */
3989 __le32 rx_mcs_set; /* Negotiated RX VHT rates */
3990 __le32 tx_max_rate; /* Max Tx data rate */
3991 __le32 tx_mcs_set; /* Negotiated TX VHT rates */
3994 struct wmi_vht_rate_set_arg {
4001 struct wmi_peer_set_rates_cmd {
4002 /* peer MAC address */
4003 struct wmi_mac_addr peer_macaddr;
4004 /* legacy rate set */
4005 struct wmi_rate_set peer_legacy_rates;
4007 struct wmi_rate_set peer_ht_rates;
4010 struct wmi_peer_set_q_empty_callback_cmd {
4011 /* unique id identifying the VDEV, generated by the caller */
4013 /* peer MAC address */
4014 struct wmi_mac_addr peer_macaddr;
4015 __le32 callback_enable;
4018 #define WMI_PEER_AUTH 0x00000001
4019 #define WMI_PEER_QOS 0x00000002
4020 #define WMI_PEER_NEED_PTK_4_WAY 0x00000004
4021 #define WMI_PEER_NEED_GTK_2_WAY 0x00000010
4022 #define WMI_PEER_APSD 0x00000800
4023 #define WMI_PEER_HT 0x00001000
4024 #define WMI_PEER_40MHZ 0x00002000
4025 #define WMI_PEER_STBC 0x00008000
4026 #define WMI_PEER_LDPC 0x00010000
4027 #define WMI_PEER_DYN_MIMOPS 0x00020000
4028 #define WMI_PEER_STATIC_MIMOPS 0x00040000
4029 #define WMI_PEER_SPATIAL_MUX 0x00200000
4030 #define WMI_PEER_VHT 0x02000000
4031 #define WMI_PEER_80MHZ 0x04000000
4032 #define WMI_PEER_PMF 0x08000000
4035 * Peer rate capabilities.
4037 * This is of interest to the ratecontrol
4038 * module which resides in the firmware. The bit definitions are
4039 * consistent with that defined in if_athrate.c.
4041 #define WMI_RC_DS_FLAG 0x01
4042 #define WMI_RC_CW40_FLAG 0x02
4043 #define WMI_RC_SGI_FLAG 0x04
4044 #define WMI_RC_HT_FLAG 0x08
4045 #define WMI_RC_RTSCTS_FLAG 0x10
4046 #define WMI_RC_TX_STBC_FLAG 0x20
4047 #define WMI_RC_RX_STBC_FLAG 0xC0
4048 #define WMI_RC_RX_STBC_FLAG_S 6
4049 #define WMI_RC_WEP_TKIP_FLAG 0x100
4050 #define WMI_RC_TS_FLAG 0x200
4051 #define WMI_RC_UAPSD_FLAG 0x400
4053 /* Maximum listen interval supported by hw in units of beacon interval */
4054 #define ATH10K_MAX_HW_LISTEN_INTERVAL 5
4056 struct wmi_peer_assoc_complete_cmd {
4057 struct wmi_mac_addr peer_macaddr;
4059 __le32 peer_new_assoc; /* 1=assoc, 0=reassoc */
4060 __le32 peer_associd; /* 16 LSBs */
4062 __le32 peer_caps; /* 16 LSBs */
4063 __le32 peer_listen_intval;
4064 __le32 peer_ht_caps;
4065 __le32 peer_max_mpdu;
4066 __le32 peer_mpdu_density; /* 0..16 */
4067 __le32 peer_rate_caps;
4068 struct wmi_rate_set peer_legacy_rates;
4069 struct wmi_rate_set peer_ht_rates;
4070 __le32 peer_nss; /* num of spatial streams */
4071 __le32 peer_vht_caps;
4072 __le32 peer_phymode;
4073 struct wmi_vht_rate_set peer_vht_rates;
4074 /* HT Operation Element of the peer. Five bytes packed in 2
4075 * INT32 array and filled from lsb to msb. */
4076 __le32 peer_ht_info[2];
4079 struct wmi_peer_assoc_complete_arg {
4084 u32 peer_flags; /* see %WMI_PEER_ */
4086 u32 peer_listen_intval;
4089 u32 peer_mpdu_density; /* 0..16 */
4090 u32 peer_rate_caps; /* see %WMI_RC_ */
4091 struct wmi_rate_set_arg peer_legacy_rates;
4092 struct wmi_rate_set_arg peer_ht_rates;
4093 u32 peer_num_spatial_streams;
4095 enum wmi_phy_mode peer_phymode;
4096 struct wmi_vht_rate_set_arg peer_vht_rates;
4099 struct wmi_peer_add_wds_entry_cmd {
4100 /* peer MAC address */
4101 struct wmi_mac_addr peer_macaddr;
4103 struct wmi_mac_addr wds_macaddr;
4106 struct wmi_peer_remove_wds_entry_cmd {
4108 struct wmi_mac_addr wds_macaddr;
4111 struct wmi_peer_q_empty_callback_event {
4112 /* peer MAC address */
4113 struct wmi_mac_addr peer_macaddr;
4117 * Channel info WMI event
4119 struct wmi_chan_info_event {
4124 __le32 rx_clear_count;
4128 struct wmi_peer_sta_kickout_event {
4129 struct wmi_mac_addr peer_macaddr;
4132 #define WMI_CHAN_INFO_FLAG_COMPLETE BIT(0)
4134 /* FIXME: empirically extrapolated */
4135 #define WMI_CHAN_INFO_MSEC(x) ((x) / 76595)
4137 /* Beacon filter wmi command info */
4138 #define BCN_FLT_MAX_SUPPORTED_IES 256
4139 #define BCN_FLT_MAX_ELEMS_IE_LIST (BCN_FLT_MAX_SUPPORTED_IES / 32)
4141 struct bss_bcn_stats {
4143 __le32 bss_bcnsdropped;
4144 __le32 bss_bcnsdelivered;
4147 struct bcn_filter_stats {
4148 __le32 bcns_dropped;
4149 __le32 bcns_delivered;
4150 __le32 activefilters;
4151 struct bss_bcn_stats bss_stats;
4154 struct wmi_add_bcn_filter_cmd {
4156 u32 ie_map[BCN_FLT_MAX_ELEMS_IE_LIST];
4159 enum wmi_sta_keepalive_method {
4160 WMI_STA_KEEPALIVE_METHOD_NULL_FRAME = 1,
4161 WMI_STA_KEEPALIVE_METHOD_UNSOLICITATED_ARP_RESPONSE = 2,
4164 /* note: ip4 addresses are in network byte order, i.e. big endian */
4165 struct wmi_sta_keepalive_arp_resp {
4166 __be32 src_ip4_addr;
4167 __be32 dest_ip4_addr;
4168 struct wmi_mac_addr dest_mac_addr;
4171 struct wmi_sta_keepalive_cmd {
4174 __le32 method; /* WMI_STA_KEEPALIVE_METHOD_ */
4175 __le32 interval; /* in seconds */
4176 struct wmi_sta_keepalive_arp_resp arp_resp;
4179 enum wmi_force_fw_hang_type {
4180 WMI_FORCE_FW_HANG_ASSERT = 1,
4181 WMI_FORCE_FW_HANG_NO_DETECT,
4182 WMI_FORCE_FW_HANG_CTRL_EP_FULL,
4183 WMI_FORCE_FW_HANG_EMPTY_POINT,
4184 WMI_FORCE_FW_HANG_STACK_OVERFLOW,
4185 WMI_FORCE_FW_HANG_INFINITE_LOOP,
4188 #define WMI_FORCE_FW_HANG_RANDOM_TIME 0xFFFFFFFF
4190 struct wmi_force_fw_hang_cmd {
4195 enum ath10k_dbglog_level {
4196 ATH10K_DBGLOG_LEVEL_VERBOSE = 0,
4197 ATH10K_DBGLOG_LEVEL_INFO = 1,
4198 ATH10K_DBGLOG_LEVEL_WARN = 2,
4199 ATH10K_DBGLOG_LEVEL_ERR = 3,
4202 /* VAP ids to enable dbglog */
4203 #define ATH10K_DBGLOG_CFG_VAP_LOG_LSB 0
4204 #define ATH10K_DBGLOG_CFG_VAP_LOG_MASK 0x0000ffff
4206 /* to enable dbglog in the firmware */
4207 #define ATH10K_DBGLOG_CFG_REPORTING_ENABLE_LSB 16
4208 #define ATH10K_DBGLOG_CFG_REPORTING_ENABLE_MASK 0x00010000
4210 /* timestamp resolution */
4211 #define ATH10K_DBGLOG_CFG_RESOLUTION_LSB 17
4212 #define ATH10K_DBGLOG_CFG_RESOLUTION_MASK 0x000E0000
4214 /* number of queued messages before sending them to the host */
4215 #define ATH10K_DBGLOG_CFG_REPORT_SIZE_LSB 20
4216 #define ATH10K_DBGLOG_CFG_REPORT_SIZE_MASK 0x0ff00000
4219 * Log levels to enable. This defines the minimum level to enable, this is
4220 * not a bitmask. See enum ath10k_dbglog_level for the values.
4222 #define ATH10K_DBGLOG_CFG_LOG_LVL_LSB 28
4223 #define ATH10K_DBGLOG_CFG_LOG_LVL_MASK 0x70000000
4226 * Note: this is a cleaned up version of a struct firmware uses. For
4227 * example, config_valid was hidden inside an array.
4229 struct wmi_dbglog_cfg_cmd {
4230 /* bitmask to hold mod id config*/
4231 __le32 module_enable;
4233 /* see ATH10K_DBGLOG_CFG_ */
4234 __le32 config_enable;
4236 /* mask of module id bits to be changed */
4237 __le32 module_valid;
4239 /* mask of config bits to be changed, see ATH10K_DBGLOG_CFG_ */
4240 __le32 config_valid;
4243 #define ATH10K_RTS_MAX 2347
4244 #define ATH10K_FRAGMT_THRESHOLD_MIN 540
4245 #define ATH10K_FRAGMT_THRESHOLD_MAX 2346
4247 #define WMI_MAX_EVENT 0x1000
4248 /* Maximum number of pending TXed WMI packets */
4249 #define WMI_SKB_HEADROOM sizeof(struct wmi_cmd_hdr)
4251 /* By default disable power save for IBSS */
4252 #define ATH10K_DEFAULT_ATIM 0
4257 int ath10k_wmi_attach(struct ath10k *ar);
4258 void ath10k_wmi_detach(struct ath10k *ar);
4259 int ath10k_wmi_wait_for_service_ready(struct ath10k *ar);
4260 int ath10k_wmi_wait_for_unified_ready(struct ath10k *ar);
4262 int ath10k_wmi_connect(struct ath10k *ar);
4263 int ath10k_wmi_pdev_set_channel(struct ath10k *ar,
4264 const struct wmi_channel_arg *);
4265 int ath10k_wmi_pdev_suspend_target(struct ath10k *ar, u32 suspend_opt);
4266 int ath10k_wmi_pdev_resume_target(struct ath10k *ar);
4267 int ath10k_wmi_pdev_set_regdomain(struct ath10k *ar, u16 rd, u16 rd2g,
4268 u16 rd5g, u16 ctl2g, u16 ctl5g,
4269 enum wmi_dfs_region dfs_reg);
4270 int ath10k_wmi_pdev_set_param(struct ath10k *ar, u32 id, u32 value);
4271 int ath10k_wmi_cmd_init(struct ath10k *ar);
4272 int ath10k_wmi_start_scan(struct ath10k *ar, const struct wmi_start_scan_arg *);
4273 void ath10k_wmi_start_scan_init(struct ath10k *ar, struct wmi_start_scan_arg *);
4274 int ath10k_wmi_stop_scan(struct ath10k *ar,
4275 const struct wmi_stop_scan_arg *arg);
4276 int ath10k_wmi_vdev_create(struct ath10k *ar, u32 vdev_id,
4277 enum wmi_vdev_type type,
4278 enum wmi_vdev_subtype subtype,
4279 const u8 macaddr[ETH_ALEN]);
4280 int ath10k_wmi_vdev_delete(struct ath10k *ar, u32 vdev_id);
4281 int ath10k_wmi_vdev_start(struct ath10k *ar,
4282 const struct wmi_vdev_start_request_arg *);
4283 int ath10k_wmi_vdev_restart(struct ath10k *ar,
4284 const struct wmi_vdev_start_request_arg *);
4285 int ath10k_wmi_vdev_stop(struct ath10k *ar, u32 vdev_id);
4286 int ath10k_wmi_vdev_up(struct ath10k *ar, u32 vdev_id, u32 aid,
4288 int ath10k_wmi_vdev_down(struct ath10k *ar, u32 vdev_id);
4289 int ath10k_wmi_vdev_set_param(struct ath10k *ar, u32 vdev_id,
4290 u32 param_id, u32 param_value);
4291 int ath10k_wmi_vdev_install_key(struct ath10k *ar,
4292 const struct wmi_vdev_install_key_arg *arg);
4293 int ath10k_wmi_peer_create(struct ath10k *ar, u32 vdev_id,
4294 const u8 peer_addr[ETH_ALEN]);
4295 int ath10k_wmi_peer_delete(struct ath10k *ar, u32 vdev_id,
4296 const u8 peer_addr[ETH_ALEN]);
4297 int ath10k_wmi_peer_flush(struct ath10k *ar, u32 vdev_id,
4298 const u8 peer_addr[ETH_ALEN], u32 tid_bitmap);
4299 int ath10k_wmi_peer_set_param(struct ath10k *ar, u32 vdev_id,
4300 const u8 *peer_addr,
4301 enum wmi_peer_param param_id, u32 param_value);
4302 int ath10k_wmi_peer_assoc(struct ath10k *ar,
4303 const struct wmi_peer_assoc_complete_arg *arg);
4304 int ath10k_wmi_set_psmode(struct ath10k *ar, u32 vdev_id,
4305 enum wmi_sta_ps_mode psmode);
4306 int ath10k_wmi_set_sta_ps_param(struct ath10k *ar, u32 vdev_id,
4307 enum wmi_sta_powersave_param param_id,
4309 int ath10k_wmi_set_ap_ps_param(struct ath10k *ar, u32 vdev_id, const u8 *mac,
4310 enum wmi_ap_ps_peer_param param_id, u32 value);
4311 int ath10k_wmi_scan_chan_list(struct ath10k *ar,
4312 const struct wmi_scan_chan_list_arg *arg);
4313 int ath10k_wmi_beacon_send_ref_nowait(struct ath10k_vif *arvif);
4314 int ath10k_wmi_pdev_set_wmm_params(struct ath10k *ar,
4315 const struct wmi_pdev_set_wmm_params_arg *arg);
4316 int ath10k_wmi_request_stats(struct ath10k *ar, enum wmi_stats_id stats_id);
4317 int ath10k_wmi_force_fw_hang(struct ath10k *ar,
4318 enum wmi_force_fw_hang_type type, u32 delay_ms);
4319 int ath10k_wmi_mgmt_tx(struct ath10k *ar, struct sk_buff *skb);
4320 int ath10k_wmi_dbglog_cfg(struct ath10k *ar, u32 module_enable);
4322 #endif /* _WMI_H_ */