fw/api/mac-cfg.h

0001 /* SPDX-License-Identifier: GPL-2.0 OR BSD-3-Clause */
0002 /*
0003  * Copyright (C) 2012-2014, 2018-2019, 2021 Intel Corporation
0004  * Copyright (C) 2013-2015 Intel Mobile Communications GmbH
0005  * Copyright (C) 2016-2017 Intel Deutschland GmbH
0006  */
0007 #ifndef __iwl_fw_api_mac_cfg_h__
0008 #define __iwl_fw_api_mac_cfg_h__
0009
0010 /**
0011  * enum iwl_mac_conf_subcmd_ids - mac configuration command IDs
0012  */
0013 enum iwl_mac_conf_subcmd_ids {
0014     /**
0015      * @LOW_LATENCY_CMD: &struct iwl_mac_low_latency_cmd
0016      */
0017     LOW_LATENCY_CMD = 0x3,
0018     /**
0019      * @CHANNEL_SWITCH_TIME_EVENT_CMD: &struct iwl_chan_switch_te_cmd
0020      */
0021     CHANNEL_SWITCH_TIME_EVENT_CMD = 0x4,
0022     /**
0023      * @MISSED_VAP_NOTIF: &struct iwl_missed_vap_notif
0024      */
0025     MISSED_VAP_NOTIF = 0xFA,
0026     /**
0027      * @SESSION_PROTECTION_CMD: &struct iwl_mvm_session_prot_cmd
0028      */
0029     SESSION_PROTECTION_CMD = 0x5,
0030     /**
0031      * @CANCEL_CHANNEL_SWITCH_CMD: &struct iwl_cancel_channel_switch_cmd
0032      */
0033     CANCEL_CHANNEL_SWITCH_CMD = 0x6,
0034
0035     /**
0036      * @SESSION_PROTECTION_NOTIF: &struct iwl_mvm_session_prot_notif
0037      */
0038     SESSION_PROTECTION_NOTIF = 0xFB,
0039
0040     /**
0041      * @PROBE_RESPONSE_DATA_NOTIF: &struct iwl_probe_resp_data_notif
0042      */
0043     PROBE_RESPONSE_DATA_NOTIF = 0xFC,
0044
0045     /**
0046      * @CHANNEL_SWITCH_START_NOTIF: &struct iwl_channel_switch_start_notif
0047      */
0048     CHANNEL_SWITCH_START_NOTIF = 0xFF,
0049
0050     /**
0051      *@CHANNEL_SWITCH_ERROR_NOTIF: &struct iwl_channel_switch_error_notif
0052      */
0053     CHANNEL_SWITCH_ERROR_NOTIF = 0xF9,
0054 };
0055
0056 #define IWL_P2P_NOA_DESC_COUNT  (2)
0057
0058 /**
0059  * struct iwl_p2p_noa_attr - NOA attr contained in probe resp FW notification
0060  *
0061  * @id: attribute id
0062  * @len_low: length low half
0063  * @len_high: length high half
0064  * @idx: instance of NoA timing
0065  * @ctwin: GO's ct window and pwer save capability
0066  * @desc: NoA descriptor
0067  * @reserved: reserved for alignment purposes
0068  */
0069 struct iwl_p2p_noa_attr {
0070     u8 id;
0071     u8 len_low;
0072     u8 len_high;
0073     u8 idx;
0074     u8 ctwin;
0075     struct ieee80211_p2p_noa_desc desc[IWL_P2P_NOA_DESC_COUNT];
0076     u8 reserved;
0077 } __packed;
0078
0079 #define IWL_PROBE_RESP_DATA_NO_CSA (0xff)
0080
0081 /**
0082  * struct iwl_probe_resp_data_notif - notification with NOA and CSA counter
0083  *
0084  * @mac_id: the mac which should send the probe response
0085  * @noa_active: notifies if the noa attribute should be handled
0086  * @noa_attr: P2P NOA attribute
0087  * @csa_counter: current csa counter
0088  * @reserved: reserved for alignment purposes
0089  */
0090 struct iwl_probe_resp_data_notif {
0091     __le32 mac_id;
0092     __le32 noa_active;
0093     struct iwl_p2p_noa_attr noa_attr;
0094     u8 csa_counter;
0095     u8 reserved[3];
0096 } __packed; /* PROBE_RESPONSE_DATA_NTFY_API_S_VER_1 */
0097
0098 /**
0099  * struct iwl_missed_vap_notif - notification of missing vap detection
0100  *
0101  * @mac_id: the mac for which the ucode sends the notification for
0102  * @num_beacon_intervals_elapsed: beacons elpased with no vap profile inside
0103  * @profile_periodicity: beacons period to have our profile inside
0104  * @reserved: reserved for alignment purposes
0105  */
0106 struct iwl_missed_vap_notif {
0107     __le32 mac_id;
0108     u8 num_beacon_intervals_elapsed;
0109     u8 profile_periodicity;
0110     u8 reserved[2];
0111 } __packed; /* MISSED_VAP_NTFY_API_S_VER_1 */
0112
0113 /**
0114  * struct iwl_channel_switch_start_notif - Channel switch start notification
0115  *
0116  * @id_and_color: ID and color of the MAC
0117  */
0118 struct iwl_channel_switch_start_notif {
0119     __le32 id_and_color;
0120 } __packed; /* CHANNEL_SWITCH_START_NTFY_API_S_VER_1 */
0121
0122 #define CS_ERR_COUNT_ERROR BIT(0)
0123 #define CS_ERR_LONG_DELAY_AFTER_CS BIT(1)
0124 #define CS_ERR_LONG_TX_BLOCK BIT(2)
0125 #define CS_ERR_TX_BLOCK_TIMER_EXPIRED BIT(3)
0126
0127 /**
0128  * struct iwl_channel_switch_error_notif - Channel switch error notification
0129  *
0130  * @mac_id: the mac for which the ucode sends the notification for
0131  * @csa_err_mask: mask of channel switch error that can occur
0132  */
0133 struct iwl_channel_switch_error_notif {
0134     __le32 mac_id;
0135     __le32 csa_err_mask;
0136 } __packed; /* CHANNEL_SWITCH_ERROR_NTFY_API_S_VER_1 */
0137
0138 /**
0139  * struct iwl_cancel_channel_switch_cmd - Cancel Channel Switch command
0140  *
0141  * @mac_id: the mac that should cancel the channel switch
0142  */
0143 struct iwl_cancel_channel_switch_cmd {
0144     __le32 mac_id;
0145 } __packed; /* MAC_CANCEL_CHANNEL_SWITCH_S_VER_1 */
0146
0147 /**
0148  * struct iwl_chan_switch_te_cmd - Channel Switch Time Event command
0149  *
0150  * @mac_id: MAC ID for channel switch
0151  * @action: action to perform, one of FW_CTXT_ACTION_*
0152  * @tsf: beacon tsf
0153  * @cs_count: channel switch count from CSA/eCSA IE
0154  * @cs_delayed_bcn_count: if set to N (!= 0) GO/AP can delay N beacon intervals
0155  *  at the new channel after the channel switch, otherwise (N == 0) expect
0156  *  beacon right after the channel switch.
0157  * @cs_mode: 1 - quiet, 0 - otherwise
0158  * @reserved: reserved for alignment purposes
0159  */
0160 struct iwl_chan_switch_te_cmd {
0161     __le32 mac_id;
0162     __le32 action;
0163     __le32 tsf;
0164     u8 cs_count;
0165     u8 cs_delayed_bcn_count;
0166     u8 cs_mode;
0167     u8 reserved;
0168 } __packed; /* MAC_CHANNEL_SWITCH_TIME_EVENT_S_VER_2 */
0169
0170 /**
0171  * struct iwl_mac_low_latency_cmd - set/clear mac to 'low-latency mode'
0172  *
0173  * @mac_id: MAC ID to whom to apply the low-latency configurations
0174  * @low_latency_rx: 1/0 to set/clear Rx low latency direction
0175  * @low_latency_tx: 1/0 to set/clear Tx low latency direction
0176  * @reserved: reserved for alignment purposes
0177  */
0178 struct iwl_mac_low_latency_cmd {
0179     __le32 mac_id;
0180     u8 low_latency_rx;
0181     u8 low_latency_tx;
0182     __le16 reserved;
0183 } __packed; /* MAC_LOW_LATENCY_API_S_VER_1 */
0184
0185 #endif /* __iwl_fw_api_mac_cfg_h__ */