1 /* SPDX-License-Identifier: GPL-2.0 OR BSD-3-Clause */
3 * Copyright (C) 2013-2015 Intel Mobile Communications GmbH
4 * Copyright (C) 2016-2017 Intel Deutschland GmbH
5 * Copyright (C) 2018-2020 Intel Corporation
7 #ifndef __iwl_fw_api_commands_h__
8 #define __iwl_fw_api_commands_h__
11 * enum iwl_mvm_command_groups - command groups for the firmware
12 * @LEGACY_GROUP: legacy group, uses command IDs from &enum iwl_legacy_cmds
13 * @LONG_GROUP: legacy group with long header, also uses command IDs
14 * from &enum iwl_legacy_cmds
15 * @SYSTEM_GROUP: system group, uses command IDs from
16 * &enum iwl_system_subcmd_ids
17 * @MAC_CONF_GROUP: MAC configuration group, uses command IDs from
18 * &enum iwl_mac_conf_subcmd_ids
19 * @PHY_OPS_GROUP: PHY operations group, uses command IDs from
20 * &enum iwl_phy_ops_subcmd_ids
21 * @DATA_PATH_GROUP: data path group, uses command IDs from
22 * &enum iwl_data_path_subcmd_ids
23 * @NAN_GROUP: NAN group, uses command IDs from &enum iwl_nan_subcmd_ids
24 * @LOCATION_GROUP: location group, uses command IDs from
25 * &enum iwl_location_subcmd_ids
26 * @PROT_OFFLOAD_GROUP: protocol offload group, uses command IDs from
27 * &enum iwl_prot_offload_subcmd_ids
28 * @REGULATORY_AND_NVM_GROUP: regulatory/NVM group, uses command IDs from
29 * &enum iwl_regulatory_and_nvm_subcmd_ids
30 * @DEBUG_GROUP: Debug group, uses command IDs from &enum iwl_debug_cmds
32 enum iwl_mvm_command_groups {
38 DATA_PATH_GROUP = 0x5,
41 PROT_OFFLOAD_GROUP = 0xb,
42 REGULATORY_AND_NVM_GROUP = 0xc,
47 * enum iwl_legacy_cmds - legacy group command IDs
49 enum iwl_legacy_cmds {
52 * Alive data from the firmware, as described in
53 * &struct iwl_alive_ntf_v3 or &struct iwl_alive_ntf_v4 or
54 * &struct iwl_alive_ntf_v5 or &struct iwl_alive_ntf_v6.
56 UCODE_ALIVE_NTFY = 0x1,
59 * @REPLY_ERROR: Cause an error in the firmware, for testing purposes.
64 * @ECHO_CMD: Send data to the device to have it returned immediately.
69 * @INIT_COMPLETE_NOTIF: Notification that initialization is complete.
71 INIT_COMPLETE_NOTIF = 0x4,
75 * Add/modify/remove a PHY context, using &struct iwl_phy_context_cmd
76 * or &struct iwl_phy_context_cmd_v1.
78 PHY_CONTEXT_CMD = 0x8,
81 * @DBG_CFG: Debug configuration command.
86 * @SCAN_ITERATION_COMPLETE_UMAC:
87 * Firmware indicates a scan iteration completed, using
88 * &struct iwl_umac_scan_iter_complete_notif.
90 SCAN_ITERATION_COMPLETE_UMAC = 0xb5,
94 * uses &struct iwl_scan_config_v1, &struct iwl_scan_config_v2
95 * or &struct iwl_scan_config
100 * @SCAN_REQ_UMAC: uses &struct iwl_scan_req_umac
105 * @SCAN_ABORT_UMAC: uses &struct iwl_umac_scan_abort
107 SCAN_ABORT_UMAC = 0xe,
110 * @SCAN_COMPLETE_UMAC: uses &struct iwl_umac_scan_complete
112 SCAN_COMPLETE_UMAC = 0xf,
115 * @BA_WINDOW_STATUS_NOTIFICATION_ID:
116 * uses &struct iwl_ba_window_status_notif
118 BA_WINDOW_STATUS_NOTIFICATION_ID = 0x13,
122 * &struct iwl_mvm_add_sta_key_cmd_v1 or
123 * &struct iwl_mvm_add_sta_key_cmd.
129 * &struct iwl_mvm_add_sta_cmd or &struct iwl_mvm_add_sta_cmd_v7.
134 * @REMOVE_STA: &struct iwl_mvm_rm_sta_cmd
139 * @FW_GET_ITEM_CMD: uses &struct iwl_fw_get_item_cmd
141 FW_GET_ITEM_CMD = 0x1a,
144 * @TX_CMD: uses &struct iwl_tx_cmd or &struct iwl_tx_cmd_gen2 or
145 * &struct iwl_tx_cmd_gen3,
146 * response in &struct iwl_mvm_tx_resp or
147 * &struct iwl_mvm_tx_resp_v3
152 * @TXPATH_FLUSH: &struct iwl_tx_path_flush_cmd
158 * &struct iwl_mvm_mgmt_mcast_key_cmd or
159 * &struct iwl_mvm_mgmt_mcast_key_cmd_v1
161 MGMT_MCAST_KEY = 0x1f,
163 /* scheduler config */
165 * @SCD_QUEUE_CFG: &struct iwl_scd_txq_cfg_cmd for older hardware,
166 * &struct iwl_tx_queue_cfg_cmd with &struct iwl_tx_queue_cfg_rsp
167 * for newer (22000) hardware.
169 SCD_QUEUE_CFG = 0x1d,
172 * @WEP_KEY: uses &struct iwl_mvm_wep_key_cmd
178 * retrieve shared memory configuration - response in
179 * &struct iwl_shared_mem_cfg
181 SHARED_MEM_CFG = 0x25,
184 * @TDLS_CHANNEL_SWITCH_CMD: uses &struct iwl_tdls_channel_switch_cmd
186 TDLS_CHANNEL_SWITCH_CMD = 0x27,
189 * @TDLS_CHANNEL_SWITCH_NOTIFICATION:
190 * uses &struct iwl_tdls_channel_switch_notif
192 TDLS_CHANNEL_SWITCH_NOTIFICATION = 0xaa,
196 * &struct iwl_tdls_config_cmd, response in &struct iwl_tdls_config_res
198 TDLS_CONFIG_CMD = 0xa7,
201 * @MAC_CONTEXT_CMD: &struct iwl_mac_ctx_cmd
203 MAC_CONTEXT_CMD = 0x28,
207 * &struct iwl_time_event_cmd, response in &struct iwl_time_event_resp
209 TIME_EVENT_CMD = 0x29, /* both CMD and response */
212 * @TIME_EVENT_NOTIFICATION: &struct iwl_time_event_notif
214 TIME_EVENT_NOTIFICATION = 0x2a,
217 * @BINDING_CONTEXT_CMD:
218 * &struct iwl_binding_cmd or &struct iwl_binding_cmd_v1
220 BINDING_CONTEXT_CMD = 0x2b,
223 * @TIME_QUOTA_CMD: &struct iwl_time_quota_cmd
225 TIME_QUOTA_CMD = 0x2c,
228 * @NON_QOS_TX_COUNTER_CMD:
229 * command is &struct iwl_nonqos_seq_query_cmd
231 NON_QOS_TX_COUNTER_CMD = 0x2d,
234 * @LEDS_CMD: command is &struct iwl_led_cmd
239 * @LQ_CMD: using &struct iwl_lq_cmd
244 * @FW_PAGING_BLOCK_CMD:
245 * &struct iwl_fw_paging_cmd
247 FW_PAGING_BLOCK_CMD = 0x4f,
250 * @SCAN_OFFLOAD_REQUEST_CMD: uses &struct iwl_scan_req_lmac
252 SCAN_OFFLOAD_REQUEST_CMD = 0x51,
255 * @SCAN_OFFLOAD_ABORT_CMD: abort the scan - no further contents
257 SCAN_OFFLOAD_ABORT_CMD = 0x52,
260 * @HOT_SPOT_CMD: uses &struct iwl_hs20_roc_req
265 * @SCAN_OFFLOAD_COMPLETE:
266 * notification, &struct iwl_periodic_scan_complete
268 SCAN_OFFLOAD_COMPLETE = 0x6D,
271 * @SCAN_OFFLOAD_UPDATE_PROFILES_CMD:
272 * update scan offload (scheduled scan) profiles/blocklist/etc.
274 SCAN_OFFLOAD_UPDATE_PROFILES_CMD = 0x6E,
277 * @MATCH_FOUND_NOTIFICATION: scan match found
279 MATCH_FOUND_NOTIFICATION = 0xd9,
282 * @SCAN_ITERATION_COMPLETE:
283 * uses &struct iwl_lmac_scan_complete_notif
285 SCAN_ITERATION_COMPLETE = 0xe7,
289 * @PHY_CONFIGURATION_CMD: &struct iwl_phy_cfg_cmd_v1 or &struct iwl_phy_cfg_cmd_v3
291 PHY_CONFIGURATION_CMD = 0x6a,
294 * @CALIB_RES_NOTIF_PHY_DB: &struct iwl_calib_res_notif_phy_db
296 CALIB_RES_NOTIF_PHY_DB = 0x6b,
299 * @PHY_DB_CMD: &struct iwl_phy_db_cmd
304 * @POWER_TABLE_CMD: &struct iwl_device_power_cmd
306 POWER_TABLE_CMD = 0x77,
309 * @PSM_UAPSD_AP_MISBEHAVING_NOTIFICATION:
310 * &struct iwl_uapsd_misbehaving_ap_notif
312 PSM_UAPSD_AP_MISBEHAVING_NOTIFICATION = 0x78,
315 * @LTR_CONFIG: &struct iwl_ltr_config_cmd
320 * @REPLY_THERMAL_MNG_BACKOFF:
321 * Thermal throttling command
323 REPLY_THERMAL_MNG_BACKOFF = 0x7e,
326 * @NVM_ACCESS_CMD: using &struct iwl_nvm_access_cmd
328 NVM_ACCESS_CMD = 0x88,
331 * @BEACON_NOTIFICATION: &struct iwl_extended_beacon_notif
333 BEACON_NOTIFICATION = 0x90,
336 * @BEACON_TEMPLATE_CMD:
337 * Uses one of &struct iwl_mac_beacon_cmd_v6,
338 * &struct iwl_mac_beacon_cmd_v7 or &struct iwl_mac_beacon_cmd
339 * depending on the device version.
341 BEACON_TEMPLATE_CMD = 0x91,
343 * @TX_ANT_CONFIGURATION_CMD: &struct iwl_tx_ant_cfg_cmd
345 TX_ANT_CONFIGURATION_CMD = 0x98,
349 * one of &struct iwl_statistics_cmd,
350 * &struct iwl_notif_statistics_v11,
351 * &struct iwl_notif_statistics_v10,
352 * &struct iwl_notif_statistics,
353 * &struct iwl_statistics_operational_ntfy_ver_14
355 STATISTICS_CMD = 0x9c,
358 * @STATISTICS_NOTIFICATION:
359 * one of &struct iwl_notif_statistics_v10,
360 * &struct iwl_notif_statistics_v11,
361 * &struct iwl_notif_statistic,
362 * &struct iwl_statistics_operational_ntfy_ver_14
363 * &struct iwl_statistics_operational_ntfy
365 STATISTICS_NOTIFICATION = 0x9d,
368 * @EOSP_NOTIFICATION:
369 * Notify that a service period ended,
370 * &struct iwl_mvm_eosp_notification
372 EOSP_NOTIFICATION = 0x9e,
375 * @REDUCE_TX_POWER_CMD:
376 * &struct iwl_dev_tx_power_cmd
378 REDUCE_TX_POWER_CMD = 0x9f,
381 * @MISSED_BEACONS_NOTIFICATION: &struct iwl_missed_beacons_notif
383 MISSED_BEACONS_NOTIFICATION = 0xa2,
386 * @MAC_PM_POWER_TABLE: using &struct iwl_mac_power_cmd
388 MAC_PM_POWER_TABLE = 0xa9,
391 * @MFUART_LOAD_NOTIFICATION: &struct iwl_mfuart_load_notif
393 MFUART_LOAD_NOTIFICATION = 0xb1,
396 * @RSS_CONFIG_CMD: &struct iwl_rss_config_cmd
398 RSS_CONFIG_CMD = 0xb3,
401 * @REPLY_RX_PHY_CMD: &struct iwl_rx_phy_info
403 REPLY_RX_PHY_CMD = 0xc0,
406 * @REPLY_RX_MPDU_CMD:
407 * &struct iwl_rx_mpdu_res_start or &struct iwl_rx_mpdu_desc
409 REPLY_RX_MPDU_CMD = 0xc1,
412 * @BAR_FRAME_RELEASE: Frame release from BAR notification, used for
413 * multi-TID BAR (previously, the BAR frame itself was reported
414 * instead). Uses &struct iwl_bar_frame_release.
416 BAR_FRAME_RELEASE = 0xc2,
420 * Frame release (reorder helper) notification, uses
421 * &struct iwl_frame_release
423 FRAME_RELEASE = 0xc3,
427 * BlockAck notification, uses &struct iwl_mvm_compressed_ba_notif
428 * or &struct iwl_mvm_ba_notif depending on the HW
432 /* Location Aware Regulatory */
434 * @MCC_UPDATE_CMD: using &struct iwl_mcc_update_cmd
436 MCC_UPDATE_CMD = 0xc8,
439 * @MCC_CHUB_UPDATE_CMD: using &struct iwl_mcc_chub_notif
441 MCC_CHUB_UPDATE_CMD = 0xc9,
444 * @MARKER_CMD: trace marker command, uses &struct iwl_mvm_marker
445 * with &struct iwl_mvm_marker_rsp
450 * @BT_PROFILE_NOTIFICATION: &struct iwl_bt_coex_profile_notif
452 BT_PROFILE_NOTIFICATION = 0xce,
455 * @BT_CONFIG: &struct iwl_bt_coex_cmd
460 * @BT_COEX_UPDATE_REDUCED_TXP:
461 * &struct iwl_bt_coex_reduced_txp_update_cmd
463 BT_COEX_UPDATE_REDUCED_TXP = 0x5c,
466 * @BT_COEX_CI: &struct iwl_bt_coex_ci_cmd
471 * @REPLY_SF_CFG_CMD: &struct iwl_sf_cfg_cmd
473 REPLY_SF_CFG_CMD = 0xd1,
475 * @REPLY_BEACON_FILTERING_CMD: &struct iwl_beacon_filter_cmd
477 REPLY_BEACON_FILTERING_CMD = 0xd2,
480 * @DTS_MEASUREMENT_NOTIFICATION:
481 * &struct iwl_dts_measurement_notif_v1 or
482 * &struct iwl_dts_measurement_notif_v2
484 DTS_MEASUREMENT_NOTIFICATION = 0xdd,
487 * @LDBG_CONFIG_CMD: configure continuous trace recording
489 LDBG_CONFIG_CMD = 0xf6,
492 * @DEBUG_LOG_MSG: Debugging log data from firmware
494 DEBUG_LOG_MSG = 0xf7,
497 * @BCAST_FILTER_CMD: &struct iwl_bcast_filter_cmd
499 BCAST_FILTER_CMD = 0xcf,
502 * @MCAST_FILTER_CMD: &struct iwl_mcast_filter_cmd
504 MCAST_FILTER_CMD = 0xd0,
507 * @D3_CONFIG_CMD: &struct iwl_d3_manager_config
509 D3_CONFIG_CMD = 0xd3,
512 * @PROT_OFFLOAD_CONFIG_CMD: Depending on firmware, uses one of
513 * &struct iwl_proto_offload_cmd_v1, &struct iwl_proto_offload_cmd_v2,
514 * &struct iwl_proto_offload_cmd_v3_small,
515 * &struct iwl_proto_offload_cmd_v3_large
517 PROT_OFFLOAD_CONFIG_CMD = 0xd4,
520 * @OFFLOADS_QUERY_CMD:
521 * No data in command, response in &struct iwl_wowlan_status
523 OFFLOADS_QUERY_CMD = 0xd5,
526 * @D0I3_END_CMD: End D0i3/D3 state, no command data
531 * @WOWLAN_PATTERNS: &struct iwl_wowlan_patterns_cmd
533 WOWLAN_PATTERNS = 0xe0,
536 * @WOWLAN_CONFIGURATION: &struct iwl_wowlan_config_cmd
538 WOWLAN_CONFIGURATION = 0xe1,
541 * @WOWLAN_TSC_RSC_PARAM: &struct iwl_wowlan_rsc_tsc_params_cmd_v4,
542 * &struct iwl_wowlan_rsc_tsc_params_cmd
544 WOWLAN_TSC_RSC_PARAM = 0xe2,
547 * @WOWLAN_TKIP_PARAM: &struct iwl_wowlan_tkip_params_cmd
549 WOWLAN_TKIP_PARAM = 0xe3,
552 * @WOWLAN_KEK_KCK_MATERIAL: &struct iwl_wowlan_kek_kck_material_cmd
554 WOWLAN_KEK_KCK_MATERIAL = 0xe4,
557 * @WOWLAN_GET_STATUSES: response in &struct iwl_wowlan_status
559 WOWLAN_GET_STATUSES = 0xe5,
562 * @SCAN_OFFLOAD_PROFILES_QUERY_CMD:
563 * No command data, response is &struct iwl_scan_offload_profiles_query
565 SCAN_OFFLOAD_PROFILES_QUERY_CMD = 0x56,
569 * enum iwl_system_subcmd_ids - system group command IDs
571 enum iwl_system_subcmd_ids {
573 * @SHARED_MEM_CFG_CMD:
574 * response in &struct iwl_shared_mem_cfg or
575 * &struct iwl_shared_mem_cfg_v2
577 SHARED_MEM_CFG_CMD = 0x0,
580 * @SOC_CONFIGURATION_CMD: &struct iwl_soc_configuration_cmd
582 SOC_CONFIGURATION_CMD = 0x01,
585 * @INIT_EXTENDED_CFG_CMD: &struct iwl_init_extended_cfg_cmd
587 INIT_EXTENDED_CFG_CMD = 0x03,
590 * @FW_ERROR_RECOVERY_CMD: &struct iwl_fw_error_recovery_cmd
592 FW_ERROR_RECOVERY_CMD = 0x7,
595 * @RFI_CONFIG_CMD: &struct iwl_rfi_config_cmd
597 RFI_CONFIG_CMD = 0xb,
600 * @RFI_GET_FREQ_TABLE_CMD: &struct iwl_rfi_config_cmd
602 RFI_GET_FREQ_TABLE_CMD = 0xc,
605 * @SYSTEM_FEATURES_CONTROL_CMD: &struct iwl_system_features_control_cmd
607 SYSTEM_FEATURES_CONTROL_CMD = 0xd,
610 * @RFI_DEACTIVATE_NOTIF: &struct iwl_rfi_deactivate_notif
612 RFI_DEACTIVATE_NOTIF = 0xff,
615 #endif /* __iwl_fw_api_commands_h__ */