/* SPDX-License-Identifier: GPL-2.0 OR BSD-3-Clause */ /* * Copyright (C) 2024 Intel Corporation * Copyright (C) 2012-2014, 2018-2022 Intel Corporation * Copyright (C) 2013-2015 Intel Mobile Communications GmbH * Copyright (C) 2016-2017 Intel Deutschland GmbH */ #ifndef __iwl_fw_api_datapath_h__ #define __iwl_fw_api_datapath_h__ /** * enum iwl_data_path_subcmd_ids - data path group commands */ enum iwl_data_path_subcmd_ids { … }; /** * struct iwl_mu_group_mgmt_cmd - VHT MU-MIMO group configuration * * @reserved: reserved * @membership_status: a bitmap of MU groups * @user_position:the position of station in a group. If the station is in the * group then bits (group * 2) is the position -1 */ struct iwl_mu_group_mgmt_cmd { … } __packed; /* MU_GROUP_ID_MNG_TABLE_API_S_VER_1 */ /** * struct iwl_mu_group_mgmt_notif - VHT MU-MIMO group id notification * * @membership_status: a bitmap of MU groups * @user_position: the position of station in a group. If the station is in the * group then bits (group * 2) is the position -1 */ struct iwl_mu_group_mgmt_notif { … } __packed; /* MU_GROUP_MNG_NTFY_API_S_VER_1 */ enum iwl_channel_estimation_flags { … }; enum iwl_time_sync_protocol_type { … }; /* WNM_TIMING_ENABLED_PROTOCOL_API_E_VER_1 */ /** * struct iwl_time_sync_cfg_cmd - TM/FTM time sync measurement configuration * * @protocols: The type of frames to raise notifications for. A bitmap * of @iwl_time_sync_protocol_type * @peer_addr: peer address with which TM/FTM measurements are required * @reserved: for alignment */ struct iwl_time_sync_cfg_cmd { … } __packed; /* WNM_80211V_TIMING_MEASUREMENT_CONFIG_CMD_API_S_VER_1 */ /** * enum iwl_synced_time_operation - PTM request options * * @IWL_SYNCED_TIME_OPERATION_READ_ARTB: read only the ARTB time * @IWL_SYNCED_TIME_OPERATION_READ_GP2: read only the GP2 time * @IWL_SYNCED_TIME_OPERATION_READ_BOTH: latch the ARTB and GP2 clocks and * provide timestamps from both clocks for the same time point */ enum iwl_synced_time_operation { … }; /** * struct iwl_synced_time_cmd - request synced GP2/ARTB timestamps * * @operation: one of &enum iwl_synced_time_operation */ struct iwl_synced_time_cmd { … } __packed; /* WNM_80211V_TIMING_CMD_API_S_VER_1 */ /** * struct iwl_synced_time_rsp - response to iwl_synced_time_cmd * * @operation: one of &enum iwl_synced_time_operation * @platform_timestamp_hi: high DWORD of the ARTB clock timestamp in nanoseconds * @platform_timestamp_lo: low DWORD of the ARTB clock timestamp in nanoseconds * @gp2_timestamp_hi: high DWORD of the GP2 clock timestamp in 10's of * nanoseconds * @gp2_timestamp_lo: low DWORD of the GP2 clock timestamp in 10's of * nanoseconds */ struct iwl_synced_time_rsp { … } __packed; /* WNM_80211V_TIMING_RSP_API_S_VER_1 */ /* PTP_CTX_MAX_DATA_SIZE_IN_API_D_VER_1 */ #define PTP_CTX_MAX_DATA_SIZE … /** * struct iwl_time_msmt_ptp_ctx - Vendor specific element * to allow a space for flexibility for the userspace App * * @ftm: FTM specific vendor element * @ftm.element_id: element id of vendor specific ie * @ftm.length: length of vendor specific ie * @ftm.reserved: for alignment * @ftm.data: vendor specific data blob * @tm: TM specific vendor element * @tm.element_id: element id of vendor specific ie * @tm.length: length of vendor specific ie * @tm.data: vendor specific data blob */ struct iwl_time_msmt_ptp_ctx { … } __packed /* PTP_CTX_VER_1 */; /** * struct iwl_time_msmt_notify - Time Sync measurement notification * for TM/FTM, along with additional meta data. * * @peer_addr: peer address * @reserved: for alignment * @dialog_token: measurement flow dialog token number * @followup_dialog_token: Measurement flow previous dialog token number * @t1_hi: high dword of t1-time of the Tx'ed action frame departure on * sender side in units of 10 nano seconds * @t1_lo: low dword of t1-time of the Tx'ed action frame departure on * sender side in units of 10 nano seconds * @t1_max_err: maximum t1-time error in units of 10 nano seconds * @t4_hi: high dword of t4-time of the Rx'ed action frame's Ack arrival on * sender side in units of 10 nano seconds * @t4_lo: low dword of t4-time of the Rx'ed action frame's Ack arrival on * sender side in units of 10 nano seconds * @t4_max_err: maximum t4-time error in units of 10 nano seconds * @t2_hi: high dword of t2-time of the Rx'ed action frame arrival on * receiver side in units of 10 nano seconds * @t2_lo: low dword of t2-time of the Rx'ed action frame arrival on * receiver side in units of 10 nano seconds * @t2_max_err: maximum t2-time error in units of 10 nano seconds * @t3_hi: high dword of t3-time of the Tx'ed action frame's Ack departure on * receiver side in units of 10 nano seconds * @t3_lo: low dword of t3-time of the Tx'ed action frame's Ack departure on * receiver side in units of 10 nano seconds * @t3_max_err: maximum t3-time error in units of 10 nano seconds * @ptp: vendor specific information element */ struct iwl_time_msmt_notify { … } __packed; /* WNM_80211V_TIMING_MEASUREMENT_NTFY_API_S_VER_1 */ /** * struct iwl_time_msmt_cfm_notify - Time Sync measurement confirmation * notification for TM/FTM. Sent on receipt of 802.11 Ack from peer for the * Tx'ed TM/FTM measurement action frame. * * @peer_addr: peer address * @reserved: for alignment * @dialog_token: measurement flow dialog token number * @t1_hi: high dword of t1-time of the Tx'ed action frame departure on * sender side in units of 10 nano seconds * @t1_lo: low dword of t1-time of the Tx'ed action frame departure on * sender side in units of 10 nano seconds * @t1_max_err: maximum t1-time error in units of 10 nano seconds * @t4_hi: high dword of t4-time of the Rx'ed action frame's Ack arrival on * sender side in units of 10 nano seconds * @t4_lo: low dword of t4-time of the Rx'ed action frame's Ack arrival on * sender side in units of 10 nano seconds * @t4_max_err: maximum t4-time error in units of 10 nano seconds */ struct iwl_time_msmt_cfm_notify { … } __packed; /* WNM_80211V_TIMING_MEASUREMENT_CONFIRM_NTFY_API_S_VER_1 */ /** * struct iwl_channel_estimation_cfg - channel estimation reporting config */ struct iwl_channel_estimation_cfg { … } __packed; /* CHEST_COLLECTOR_FILTER_CMD_API_S_VER_1 */ enum iwl_datapath_monitor_notif_type { … }; struct iwl_datapath_monitor_notif { … } __packed; /* MONITOR_NTF_API_S_VER_1 */ /** * enum iwl_thermal_dual_chain_req_events - firmware SMPS request event * @THERMAL_DUAL_CHAIN_REQ_ENABLE: (re-)enable dual-chain operation * (subject to other constraints) * @THERMAL_DUAL_CHAIN_REQ_DISABLE: disable dual-chain operation * (static SMPS) */ enum iwl_thermal_dual_chain_req_events { … }; /* THERMAL_DUAL_CHAIN_DISABLE_STATE_API_E_VER_1 */ /** * struct iwl_thermal_dual_chain_request - SMPS request * @event: the type of request, see &enum iwl_thermal_dual_chain_req_events */ struct iwl_thermal_dual_chain_request { … } __packed; /* THERMAL_DUAL_CHAIN_DISABLE_REQ_NTFY_API_S_VER_1 */ enum iwl_rlc_chain_info { … }; /** * struct iwl_rlc_properties - RLC properties * @rx_chain_info: RX chain info, &enum iwl_rlc_chain_info * @reserved: reserved */ struct iwl_rlc_properties { … } __packed; /* RLC_PROPERTIES_S_VER_1 */ enum iwl_sad_mode { … }; /** * struct iwl_sad_properties - SAD properties * @chain_a_sad_mode: chain A SAD mode, &enum iwl_sad_mode * @chain_b_sad_mode: chain B SAD mode, &enum iwl_sad_mode * @mac_id: MAC index * @reserved: reserved */ struct iwl_sad_properties { … } __packed; /** * struct iwl_rlc_config_cmd - RLC configuration * @phy_id: PHY index * @rlc: RLC properties, &struct iwl_rlc_properties * @sad: SAD (single antenna diversity) options, &struct iwl_sad_properties * @flags: flags (unused) * @reserved: reserved */ struct iwl_rlc_config_cmd { … } __packed; /* RLC_CONFIG_CMD_API_S_VER_2 */ #define IWL_MAX_BAID_OLD … #define IWL_MAX_BAID … /** * enum iwl_rx_baid_action - BAID allocation/config action * @IWL_RX_BAID_ACTION_ADD: add a new BAID session * @IWL_RX_BAID_ACTION_MODIFY: modify the BAID session * @IWL_RX_BAID_ACTION_REMOVE: remove the BAID session */ enum iwl_rx_baid_action { … }; /* RX_BAID_ALLOCATION_ACTION_E_VER_1 */ /** * struct iwl_rx_baid_cfg_cmd_alloc - BAID allocation data * @sta_id_mask: station ID mask * @tid: the TID for this session * @reserved: reserved * @ssn: the starting sequence number * @win_size: RX BA session window size */ struct iwl_rx_baid_cfg_cmd_alloc { … } __packed; /* RX_BAID_ALLOCATION_ADD_CMD_API_S_VER_1 */ /** * struct iwl_rx_baid_cfg_cmd_modify - BAID modification data * @old_sta_id_mask: old station ID mask * @new_sta_id_mask: new station ID mask * @tid: TID of the BAID */ struct iwl_rx_baid_cfg_cmd_modify { … } __packed; /* RX_BAID_ALLOCATION_MODIFY_CMD_API_S_VER_2 */ /** * struct iwl_rx_baid_cfg_cmd_remove_v1 - BAID removal data * @baid: the BAID to remove */ struct iwl_rx_baid_cfg_cmd_remove_v1 { … } __packed; /* RX_BAID_ALLOCATION_REMOVE_CMD_API_S_VER_1 */ /** * struct iwl_rx_baid_cfg_cmd_remove - BAID removal data * @sta_id_mask: the station mask of the BAID to remove * @tid: the TID of the BAID to remove */ struct iwl_rx_baid_cfg_cmd_remove { … } __packed; /* RX_BAID_ALLOCATION_REMOVE_CMD_API_S_VER_2 */ /** * struct iwl_rx_baid_cfg_cmd - BAID allocation/config command * @action: the action, from &enum iwl_rx_baid_action * @alloc: allocation data * @modify: modify data * @remove_v1: remove data (version 1) * @remove: remove data */ struct iwl_rx_baid_cfg_cmd { … } __packed; /* RX_BAID_ALLOCATION_CONFIG_CMD_API_S_VER_2 */ /** * struct iwl_rx_baid_cfg_resp - BAID allocation response * @baid: the allocated BAID */ struct iwl_rx_baid_cfg_resp { … }; /* RX_BAID_ALLOCATION_RESPONSE_API_S_VER_1 */ /** * enum iwl_scd_queue_cfg_operation - scheduler queue operation * @IWL_SCD_QUEUE_ADD: allocate a new queue * @IWL_SCD_QUEUE_REMOVE: remove a queue * @IWL_SCD_QUEUE_MODIFY: modify a queue */ enum iwl_scd_queue_cfg_operation { … }; /** * struct iwl_scd_queue_cfg_cmd - scheduler queue allocation command * @operation: the operation, see &enum iwl_scd_queue_cfg_operation * @u: union depending on command usage * @u.add.sta_mask: station mask * @u.add.tid: TID * @u.add.reserved: reserved * @u.add.flags: flags from &enum iwl_tx_queue_cfg_actions, except * %TX_QUEUE_CFG_ENABLE_QUEUE is not valid * @u.add.cb_size: size code * @u.add.bc_dram_addr: byte-count table IOVA * @u.add.tfdq_dram_addr: TFD queue IOVA * @u.remove.sta_mask: station mask of queue to remove * @u.remove.tid: TID of queue to remove * @u.modify.old_sta_mask: old station mask for modify * @u.modify.tid: TID of queue to modify * @u.modify.new_sta_mask: new station mask for modify */ struct iwl_scd_queue_cfg_cmd { … } __packed; /* TX_QUEUE_CFG_CMD_API_S_VER_3 */ /** * enum iwl_sec_key_flags - security key command key flags * @IWL_SEC_KEY_FLAG_CIPHER_MASK: cipher mask * @IWL_SEC_KEY_FLAG_CIPHER_WEP: WEP cipher * @IWL_SEC_KEY_FLAG_CIPHER_CCMP: CCMP/CMAC cipher * @IWL_SEC_KEY_FLAG_CIPHER_TKIP: TKIP cipher * @IWL_SEC_KEY_FLAG_CIPHER_GCMP: GCMP/GMAC cipher * @IWL_SEC_KEY_FLAG_NO_TX: don't install for TX * @IWL_SEC_KEY_FLAG_KEY_SIZE: large key size (WEP-104, GCMP-256, GMAC-256) * @IWL_SEC_KEY_FLAG_MFP: MFP is in used for this key * @IWL_SEC_KEY_FLAG_MCAST_KEY: this is a multicast key * @IWL_SEC_KEY_FLAG_SPP_AMSDU: SPP A-MSDU should be used */ enum iwl_sec_key_flags { … }; #define IWL_SEC_WEP_KEY_OFFSET … /** * struct iwl_sec_key_cmd - security key command * @action: action from &enum iwl_ctxt_action * @u: union depending on command type * @u.add.sta_mask: station mask for the new key * @u.add.key_id: key ID (0-7) for the new key * @u.add.key_flags: key flags per &enum iwl_sec_key_flags * @u.add.key: key material. WEP keys should start from &IWL_SEC_WEP_KEY_OFFSET. * @u.add.tkip_mic_rx_key: TKIP MIC RX key * @u.add.tkip_mic_tx_key: TKIP MIC TX key * @u.add.rx_seq: RX sequence counter value * @u.add.tx_seq: TX sequence counter value * @u.modify.old_sta_mask: old station mask * @u.modify.new_sta_mask: new station mask * @u.modify.key_id: key ID * @u.modify.key_flags: new key flags * @u.remove.sta_mask: station mask * @u.remove.key_id: key ID * @u.remove.key_flags: key flags */ struct iwl_sec_key_cmd { … } __packed; /* SEC_KEY_CMD_API_S_VER_1 */ #endif /* __iwl_fw_api_datapath_h__ */