root/drivers/net/wireless/intel/iwlwifi/fw/api/datapath.h
/* SPDX-License-Identifier: GPL-2.0 OR BSD-3-Clause */
/*
 * Copyright (C) 2024-2025 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 {
        /**
         * @DQA_ENABLE_CMD: &struct iwl_dqa_enable_cmd
         */
        DQA_ENABLE_CMD = 0x0,

        /**
         * @UPDATE_MU_GROUPS_CMD: &struct iwl_mu_group_mgmt_cmd
         */
        UPDATE_MU_GROUPS_CMD = 0x1,

        /**
         * @TRIGGER_RX_QUEUES_NOTIF_CMD: &struct iwl_rxq_sync_cmd
         */
        TRIGGER_RX_QUEUES_NOTIF_CMD = 0x2,

        /**
         * @WNM_PLATFORM_PTM_REQUEST_CMD: &struct iwl_time_sync_cfg_cmd
         */
        WNM_PLATFORM_PTM_REQUEST_CMD = 0x3,

        /**
         * @WNM_80211V_TIMING_MEASUREMENT_CONFIG_CMD:
         *      &struct iwl_time_sync_cfg_cmd
         */
        WNM_80211V_TIMING_MEASUREMENT_CONFIG_CMD = 0x4,

        /**
         * @STA_HE_CTXT_CMD: &struct iwl_he_sta_context_cmd_v1,
         *      &struct iwl_he_sta_context_cmd_v2 or
         *      &struct iwl_he_sta_context_cmd_v3
         */
        STA_HE_CTXT_CMD = 0x7,

        /**
         * @RLC_CONFIG_CMD: &struct iwl_rlc_config_cmd
         */
        RLC_CONFIG_CMD = 0x8,

        /**
         * @RFH_QUEUE_CONFIG_CMD: &struct iwl_rfh_queue_config
         */
        RFH_QUEUE_CONFIG_CMD = 0xD,

        /**
         * @TLC_MNG_CONFIG_CMD: &struct iwl_tlc_config_cmd_v4
         */
        TLC_MNG_CONFIG_CMD = 0xF,

        /**
         * @HE_AIR_SNIFFER_CONFIG_CMD: &struct iwl_he_monitor_cmd
         */
        HE_AIR_SNIFFER_CONFIG_CMD = 0x13,

        /**
         * @CHEST_COLLECTOR_FILTER_CONFIG_CMD: Configure the CSI
         *      matrix collection, uses &struct iwl_channel_estimation_cfg
         */
        CHEST_COLLECTOR_FILTER_CONFIG_CMD = 0x14,

        /**
         * @RX_BAID_ALLOCATION_CONFIG_CMD: Allocate/deallocate a BAID for an RX
         *      blockack session, uses &struct iwl_rx_baid_cfg_cmd for the
         *      command, and &struct iwl_rx_baid_cfg_resp as a response.
         */
        RX_BAID_ALLOCATION_CONFIG_CMD = 0x16,

        /**
         * @SCD_QUEUE_CONFIG_CMD: new scheduler queue allocation/config/removal
         *      command, uses &struct iwl_scd_queue_cfg_cmd and the response
         *      is (same as before) &struct iwl_tx_queue_cfg_rsp.
         */
        SCD_QUEUE_CONFIG_CMD = 0x17,

        /**
         * @SEC_KEY_CMD: security key command, uses &struct iwl_sec_key_cmd
         */
        SEC_KEY_CMD = 0x18,

        /**
         * @ESR_MODE_NOTIF: notification to recommend/force a wanted esr mode,
         *      uses &struct iwl_esr_mode_notif or &struct iwl_esr_mode_notif_v1
         */
        ESR_MODE_NOTIF = 0xF3,

        /**
         * @MONITOR_NOTIF: Datapath monitoring notification, using
         *      &struct iwl_datapath_monitor_notif
         */
        MONITOR_NOTIF = 0xF4,

        /**
         * @RX_NO_DATA_NOTIF: &struct iwl_rx_no_data or &struct iwl_rx_no_data_ver_3
         */
        RX_NO_DATA_NOTIF = 0xF5,

        /**
         * @THERMAL_DUAL_CHAIN_REQUEST: firmware request for SMPS mode,
         *      &struct iwl_thermal_dual_chain_request
         */
        THERMAL_DUAL_CHAIN_REQUEST = 0xF6,

        /**
         * @TLC_MNG_UPDATE_NOTIF: &struct iwl_tlc_update_notif
         */
        TLC_MNG_UPDATE_NOTIF = 0xF7,

        /**
         * @BEACON_FILTER_IN_NOTIF: &struct iwl_beacon_filter_notif
         */
        BEACON_FILTER_IN_NOTIF = 0xF8,

        /**
         * @PHY_AIR_SNIFFER_NOTIF: &struct iwl_rx_phy_air_sniffer_ntfy
         */
        PHY_AIR_SNIFFER_NOTIF = 0xF9,

        /**
         * @STA_PM_NOTIF: &struct iwl_mvm_pm_state_notification
         */
        STA_PM_NOTIF = 0xFD,

        /**
         * @MU_GROUP_MGMT_NOTIF: &struct iwl_mu_group_mgmt_notif
         */
        MU_GROUP_MGMT_NOTIF = 0xFE,

        /**
         * @RX_QUEUES_NOTIFICATION: &struct iwl_rxq_sync_notification
         */
        RX_QUEUES_NOTIFICATION = 0xFF,
};

/**
 * 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 {
        __le32 reserved;
        __le32 membership_status[2];
        __le32 user_position[4];
} __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 {
        __le32 membership_status[2];
        __le32 user_position[4];
} __packed; /* MU_GROUP_MNG_NTFY_API_S_VER_1 */

enum iwl_channel_estimation_flags {
        IWL_CHANNEL_ESTIMATION_ENABLE   = BIT(0),
        IWL_CHANNEL_ESTIMATION_TIMER    = BIT(1),
        IWL_CHANNEL_ESTIMATION_COUNTER  = BIT(2),
};

enum iwl_time_sync_protocol_type {
        IWL_TIME_SYNC_PROTOCOL_TM       = BIT(0),
        IWL_TIME_SYNC_PROTOCOL_FTM      = BIT(1),
}; /* 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 {
        __le32 protocols;
        u8 peer_addr[ETH_ALEN];
        u8 reserved[2];
} __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 {
        IWL_SYNCED_TIME_OPERATION_READ_ARTB = 1,
        IWL_SYNCED_TIME_OPERATION_READ_GP2,
        IWL_SYNCED_TIME_OPERATION_READ_BOTH,
};

/**
 * struct iwl_synced_time_cmd - request synced GP2/ARTB timestamps
 *
 * @operation: one of &enum iwl_synced_time_operation
 */
struct iwl_synced_time_cmd {
        __le32 operation;
} __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 {
        __le32 operation;
        __le32 platform_timestamp_hi;
        __le32 platform_timestamp_lo;
        __le32 gp2_timestamp_hi;
        __le32 gp2_timestamp_lo;
} __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   128

/**
 * 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 {
        /* Differentiate between FTM and TM specific Vendor elements */
        union {
                struct {
                        u8 element_id;
                        u8 length;
                        __le16 reserved;
                        u8 data[PTP_CTX_MAX_DATA_SIZE];
                } ftm;
                struct {
                        u8 element_id;
                        u8 length;
                        u8 data[PTP_CTX_MAX_DATA_SIZE];
                } tm;
        };
} __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 {
        u8 peer_addr[ETH_ALEN];
        u8 reserved[2];
        __le32 dialog_token;
        __le32 followup_dialog_token;
        __le32 t1_hi;
        __le32 t1_lo;
        __le32 t1_max_err;
        __le32 t4_hi;
        __le32 t4_lo;
        __le32 t4_max_err;
        __le32 t2_hi;
        __le32 t2_lo;
        __le32 t2_max_err;
        __le32 t3_hi;
        __le32 t3_lo;
        __le32 t3_max_err;
        struct iwl_time_msmt_ptp_ctx ptp;
} __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 {
        u8 peer_addr[ETH_ALEN];
        u8 reserved[2];
        __le32 dialog_token;
        __le32 t1_hi;
        __le32 t1_lo;
        __le32 t1_max_err;
        __le32 t4_hi;
        __le32 t4_lo;
        __le32 t4_max_err;
} __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 {
        /**
         * @flags: flags, see &enum iwl_channel_estimation_flags
         */
        __le32 flags;
        /**
         * @timer: if enabled via flags, automatically disable after this many
         *      microseconds
         */
        __le32 timer;
        /**
         * @count: if enabled via flags, automatically disable after this many
         *      frames with channel estimation matrix were captured
         */
        __le32 count;
        /**
         * @rate_n_flags_mask: only try to record the channel estimation matrix
         *      if the rate_n_flags value for the received frame (let's call
         *      that rx_rnf) matches the mask/value given here like this:
         *      (rx_rnf & rate_n_flags_mask) == rate_n_flags_val.
         */
        __le32 rate_n_flags_mask;
        /**
         * @rate_n_flags_val: see @rate_n_flags_mask
         */
        __le32 rate_n_flags_val;
        /**
         * @reserved: reserved (for alignment)
         */
        __le32 reserved;
        /**
         * @frame_types: bitmap of frame types to capture, the received frame's
         *      subtype|type takes 6 bits in the frame and the corresponding bit
         *      in this field must be set to 1 to capture channel estimation for
         *      that frame type. Set to all-ones to enable capturing for all
         *      frame types.
         */
        __le64 frame_types;
} __packed; /* CHEST_COLLECTOR_FILTER_CMD_API_S_VER_1 */

enum iwl_datapath_monitor_notif_type {
        IWL_DP_MON_NOTIF_TYPE_EXT_CCA,
};

struct iwl_datapath_monitor_notif {
        __le32 type;
        u8 link_id;
        u8 reserved[3];
} __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_REQ_ENABLE,
        THERMAL_DUAL_CHAIN_REQ_DISABLE,
}; /* 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 {
        __le32 event;
} __packed; /* THERMAL_DUAL_CHAIN_DISABLE_REQ_NTFY_API_S_VER_1 */

enum iwl_rlc_chain_info {
        IWL_RLC_CHAIN_INFO_DRIVER_FORCE         = BIT(0),
        IWL_RLC_CHAIN_INFO_VALID                = 0x000e,
        IWL_RLC_CHAIN_INFO_FORCE                = 0x0070,
        IWL_RLC_CHAIN_INFO_FORCE_MIMO           = 0x0380,
        IWL_RLC_CHAIN_INFO_COUNT                = 0x0c00,
        IWL_RLC_CHAIN_INFO_MIMO_COUNT           = 0x3000,
};

/**
 * struct iwl_rlc_properties - RLC properties
 * @rx_chain_info: RX chain info, &enum iwl_rlc_chain_info
 * @reserved: reserved
 */
struct iwl_rlc_properties {
        __le32 rx_chain_info;
        __le32 reserved;
} __packed; /* RLC_PROPERTIES_S_VER_1 */

enum iwl_sad_mode {
        IWL_SAD_MODE_ENABLED            = BIT(0),
        IWL_SAD_MODE_DEFAULT_ANT_MSK    = 0x6,
        IWL_SAD_MODE_DEFAULT_ANT_FW     = 0x0,
        IWL_SAD_MODE_DEFAULT_ANT_A      = 0x2,
        IWL_SAD_MODE_DEFAULT_ANT_B      = 0x4,
};

/**
 * 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 {
        __le32 chain_a_sad_mode;
        __le32 chain_b_sad_mode;
        __le32 mac_id;
        __le32 reserved;
} __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 {
        __le32 phy_id;
        struct iwl_rlc_properties rlc;
        struct iwl_sad_properties sad;
        u8 flags;
        u8 reserved[3];
} __packed; /* RLC_CONFIG_CMD_API_S_VER_2 */

#define IWL_MAX_BAID_OLD        16 /* MAX_IMMEDIATE_BA_API_D_VER_2 */
#define IWL_MAX_BAID            32 /* MAX_IMMEDIATE_BA_API_D_VER_3 */

/**
 * 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 {
        IWL_RX_BAID_ACTION_ADD,
        IWL_RX_BAID_ACTION_MODIFY,
        IWL_RX_BAID_ACTION_REMOVE,
}; /*  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 {
        __le32 sta_id_mask;
        u8 tid;
        u8 reserved[3];
        __le16 ssn;
        __le16 win_size;
} __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 {
        __le32 old_sta_id_mask;
        __le32 new_sta_id_mask;
        __le32 tid;
} __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 {
        __le32 baid;
} __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 {
        __le32 sta_id_mask;
        __le32 tid;
} __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 {
        __le32 action;
        union {
                struct iwl_rx_baid_cfg_cmd_alloc alloc;
                struct iwl_rx_baid_cfg_cmd_modify modify;
                struct iwl_rx_baid_cfg_cmd_remove_v1 remove_v1;
                struct iwl_rx_baid_cfg_cmd_remove remove;
        }; /* RX_BAID_ALLOCATION_OPERATION_API_U_VER_2 */
} __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 {
        __le32 baid;
}; /* 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 {
        IWL_SCD_QUEUE_ADD = 0,
        IWL_SCD_QUEUE_REMOVE = 1,
        IWL_SCD_QUEUE_MODIFY = 2,
};

/**
 * 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 {
        __le32 operation;
        union {
                struct {
                        __le32 sta_mask;
                        u8 tid;
                        u8 reserved[3];
                        __le32 flags;
                        __le32 cb_size;
                        __le64 bc_dram_addr;
                        __le64 tfdq_dram_addr;
                } __packed add; /* TX_QUEUE_CFG_CMD_ADD_API_S_VER_1 */
                struct {
                        __le32 sta_mask;
                        __le32 tid;
                } __packed remove; /* TX_QUEUE_CFG_CMD_REMOVE_API_S_VER_1 */
                struct {
                        __le32 old_sta_mask;
                        __le32 tid;
                        __le32 new_sta_mask;
                } __packed modify; /* TX_QUEUE_CFG_CMD_MODIFY_API_S_VER_1 */
        } __packed u; /* TX_QUEUE_CFG_CMD_OPERATION_API_U_VER_1 */
} __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 {
        IWL_SEC_KEY_FLAG_CIPHER_MASK    = 0x07,
        IWL_SEC_KEY_FLAG_CIPHER_WEP     = 0x01,
        IWL_SEC_KEY_FLAG_CIPHER_CCMP    = 0x02,
        IWL_SEC_KEY_FLAG_CIPHER_TKIP    = 0x03,
        IWL_SEC_KEY_FLAG_CIPHER_GCMP    = 0x05,
        IWL_SEC_KEY_FLAG_NO_TX          = 0x08,
        IWL_SEC_KEY_FLAG_KEY_SIZE       = 0x10,
        IWL_SEC_KEY_FLAG_MFP            = 0x20,
        IWL_SEC_KEY_FLAG_MCAST_KEY      = 0x40,
        IWL_SEC_KEY_FLAG_SPP_AMSDU      = 0x80,
};

#define IWL_SEC_WEP_KEY_OFFSET  3

/**
 * 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 {
        __le32 action;
        union {
                struct {
                        __le32 sta_mask;
                        __le32 key_id;
                        __le32 key_flags;
                        u8 key[32];
                        u8 tkip_mic_rx_key[8];
                        u8 tkip_mic_tx_key[8];
                        __le64 rx_seq;
                        __le64 tx_seq;
                } __packed add; /* SEC_KEY_ADD_CMD_API_S_VER_1 */
                struct {
                        __le32 old_sta_mask;
                        __le32 new_sta_mask;
                        __le32 key_id;
                        __le32 key_flags;
                } __packed modify; /* SEC_KEY_MODIFY_CMD_API_S_VER_1 */
                struct {
                        __le32 sta_mask;
                        __le32 key_id;
                        __le32 key_flags;
                } __packed remove; /* SEC_KEY_REMOVE_CMD_API_S_VER_1 */
        } __packed u; /* SEC_KEY_OPERATION_API_U_VER_1 */
} __packed; /* SEC_KEY_CMD_API_S_VER_1 */

#endif /* __iwl_fw_api_datapath_h__ */