mirrors/linux-stable
1
0
Fork 0
mirror of https://git.kernel.org/pub/scm/linux/kernel/git/stable/linux.git synced 2024-09-14 06:35:12 +00:00
Code Issues Releases Wiki Activity
linux-stable/drivers/staging/wfx/hif_api_cmd.h
Jérôme Pouiller a3c529a835 staging: wfx: simplify handling of IEEE80211_TX_CTL_SEND_AFTER_DTIM 
When mac80211 ask for a frame to be sent after a DTIM, driver should:
  1. Update TIM with multicast bit set (using update_ie). This function
     can be called whenever.
  2. Keep buffered all frames marked "after dtim"
  3. When it receive a suspend_resume indication (see
     wfx_suspend_resume_mc()), send all the buffered frames. This
     indication is sent by the firmware 4ms before the dtim.
  4. If one of the frames returns status "REQUEUE", it means that the
     DTIM period was ended before to be able to send the frame.
  5. When all the buffered frames were sent or if DTIM period was ended,
     driver should update the TIM with multicast bit reset.

All the mess with the asynchronous works can be dropped.

Signed-off-by: Jérôme Pouiller <jerome.pouiller@silabs.com>
Link: https://lore.kernel.org/r/20200115135338.14374-58-Jerome.Pouiller@silabs.com
Signed-off-by: Greg Kroah-Hartman <gregkh@linuxfoundation.org>
2020-01-16 20:59:52 +01:00

674 lines
16 KiB
C
Raw Blame History

/* SPDX-License-Identifier: Apache-2.0 */
/*
* WFx hardware interface definitions
*
* Copyright (c) 2018-2019, Silicon Laboratories Inc.
*/
#ifndef WFX_HIF_API_CMD_H
#define WFX_HIF_API_CMD_H
#include "hif_api_general.h"
#define HIF_NUM_AC 4
#define HIF_API_SSID_SIZE API_SSID_SIZE
enum hif_requests_ids {
HIF_REQ_ID_RESET = 0x0a,
HIF_REQ_ID_READ_MIB = 0x05,
HIF_REQ_ID_WRITE_MIB = 0x06,
HIF_REQ_ID_START_SCAN = 0x07,
HIF_REQ_ID_STOP_SCAN = 0x08,
HIF_REQ_ID_TX = 0x04,
HIF_REQ_ID_JOIN = 0x0b,
HIF_REQ_ID_SET_PM_MODE = 0x10,
HIF_REQ_ID_SET_BSS_PARAMS = 0x11,
HIF_REQ_ID_ADD_KEY = 0x0c,
HIF_REQ_ID_REMOVE_KEY = 0x0d,
HIF_REQ_ID_EDCA_QUEUE_PARAMS = 0x13,
HIF_REQ_ID_START = 0x17,
HIF_REQ_ID_BEACON_TRANSMIT = 0x18,
HIF_REQ_ID_UPDATE_IE = 0x1b,
HIF_REQ_ID_MAP_LINK = 0x1c,
};
enum hif_confirmations_ids {
HIF_CNF_ID_RESET = 0x0a,
HIF_CNF_ID_READ_MIB = 0x05,
HIF_CNF_ID_WRITE_MIB = 0x06,
HIF_CNF_ID_START_SCAN = 0x07,
HIF_CNF_ID_STOP_SCAN = 0x08,
HIF_CNF_ID_TX = 0x04,
HIF_CNF_ID_MULTI_TRANSMIT = 0x1e,
HIF_CNF_ID_JOIN = 0x0b,
HIF_CNF_ID_SET_PM_MODE = 0x10,
HIF_CNF_ID_SET_BSS_PARAMS = 0x11,
HIF_CNF_ID_ADD_KEY = 0x0c,
HIF_CNF_ID_REMOVE_KEY = 0x0d,
HIF_CNF_ID_EDCA_QUEUE_PARAMS = 0x13,
HIF_CNF_ID_START = 0x17,
HIF_CNF_ID_BEACON_TRANSMIT = 0x18,
HIF_CNF_ID_UPDATE_IE = 0x1b,
HIF_CNF_ID_MAP_LINK = 0x1c,
};
enum hif_indications_ids {
HIF_IND_ID_RX = 0x84,
HIF_IND_ID_SCAN_CMPL = 0x86,
HIF_IND_ID_JOIN_COMPLETE = 0x8f,
HIF_IND_ID_SET_PM_MODE_CMPL = 0x89,
HIF_IND_ID_SUSPEND_RESUME_TX = 0x8c,
HIF_IND_ID_EVENT = 0x85
};
union hif_commands_ids {
enum hif_requests_ids request;
enum hif_confirmations_ids confirmation;
enum hif_indications_ids indication;
};
enum hif_status {
HIF_STATUS_SUCCESS = 0x0,
HIF_STATUS_FAILURE = 0x1,
HIF_INVALID_PARAMETER = 0x2,
HIF_STATUS_WARNING = 0x3,
HIF_ERROR_UNSUPPORTED_MSG_ID = 0x4,
HIF_STATUS_DECRYPTFAILURE = 0x10,
HIF_STATUS_MICFAILURE = 0x11,
HIF_STATUS_NO_KEY_FOUND = 0x12,
HIF_STATUS_RETRY_EXCEEDED = 0x13,
HIF_STATUS_TX_LIFETIME_EXCEEDED = 0x14,
HIF_REQUEUE = 0x15,
HIF_STATUS_REFUSED = 0x16,
HIF_STATUS_BUSY = 0x17
};
struct hif_reset_flags {
u8 reset_stat:1;
u8 reset_all_int:1;
u8 reserved1:6;
u8 reserved2[3];
} __packed;
struct hif_req_reset {
struct hif_reset_flags reset_flags;
} __packed;
struct hif_cnf_reset {
u32 status;
} __packed;
struct hif_req_read_mib {
u16 mib_id;
u16 reserved;
} __packed;
struct hif_cnf_read_mib {
u32 status;
u16 mib_id;
u16 length;
u8 mib_data[];
} __packed;
struct hif_req_write_mib {
u16 mib_id;
u16 length;
u8 mib_data[];
} __packed;
struct hif_cnf_write_mib {
u32 status;
} __packed;
struct hif_ie_flags {
u8 beacon:1;
u8 probe_resp:1;
u8 probe_req:1;
u8 reserved1:5;
u8 reserved2;
} __packed;
struct hif_ie_tlv {
u8 type;
u8 length;
u8 data[];
} __packed;
struct hif_req_update_ie {
struct hif_ie_flags ie_flags;
u16 num_ies;
struct hif_ie_tlv ie[];
} __packed;
struct hif_cnf_update_ie {
u32 status;
} __packed;
struct hif_scan_type {
u8 type:1;
u8 mode:1;
u8 reserved:6;
} __packed;
struct hif_scan_flags {
u8 fbg:1;
u8 reserved1:1;
u8 pre:1;
u8 reserved2:5;
} __packed;
struct hif_auto_scan_param {
u16 interval;
u8 reserved;
s8 rssi_thr;
} __packed;
struct hif_ssid_def {
u32 ssid_length;
u8 ssid[HIF_API_SSID_SIZE];
} __packed;
#define HIF_API_MAX_NB_SSIDS 2
#define HIF_API_MAX_NB_CHANNELS 14
struct hif_req_start_scan {
u8 band;
struct hif_scan_type scan_type;
struct hif_scan_flags scan_flags;
u8 max_transmit_rate;
struct hif_auto_scan_param auto_scan_param;
u8 num_of_probe_requests;
u8 probe_delay;
u8 num_of_ssids;
u8 num_of_channels;
u32 min_channel_time;
u32 max_channel_time;
s32 tx_power_level;
u8 ssid_and_channel_lists[];
} __packed;
struct hif_req_start_scan_alt {
u8 band;
struct hif_scan_type scan_type;
struct hif_scan_flags scan_flags;
u8 max_transmit_rate;
struct hif_auto_scan_param auto_scan_param;
u8 num_of_probe_requests;
u8 probe_delay;
u8 num_of_ssids;
u8 num_of_channels;
u32 min_channel_time;
u32 max_channel_time;
s32 tx_power_level;
struct hif_ssid_def ssid_def[HIF_API_MAX_NB_SSIDS];
u8 channel_list[];
} __packed;
struct hif_cnf_start_scan {
u32 status;
} __packed;
struct hif_cnf_stop_scan {
u32 status;
} __packed;
enum hif_pm_mode_status {
HIF_PM_MODE_ACTIVE = 0x0,
HIF_PM_MODE_PS = 0x1,
HIF_PM_MODE_UNDETERMINED = 0x2
};
struct hif_ind_scan_cmpl {
u32 status;
u8 pm_mode;
u8 num_channels_completed;
u16 reserved;
} __packed;
enum hif_queue_id {
HIF_QUEUE_ID_BACKGROUND = 0x0,
HIF_QUEUE_ID_BESTEFFORT = 0x1,
HIF_QUEUE_ID_VIDEO = 0x2,
HIF_QUEUE_ID_VOICE = 0x3
};
enum hif_frame_format {
HIF_FRAME_FORMAT_NON_HT = 0x0,
HIF_FRAME_FORMAT_MIXED_FORMAT_HT = 0x1,
HIF_FRAME_FORMAT_GF_HT_11N = 0x2
};
enum hif_stbc {
HIF_STBC_NOT_ALLOWED = 0x0,
HIF_STBC_ALLOWED = 0x1
};
struct hif_queue {
u8 queue_id:2;
u8 peer_sta_id:4;
u8 reserved:2;
} __packed;
struct hif_data_flags {
u8 more:1;
u8 fc_offset:3;
u8 after_dtim:1;
u8 reserved:3;
} __packed;
struct hif_tx_flags {
u8 start_exp:1;
u8 reserved:3;
u8 retry_policy_index:4;
} __packed;
struct hif_ht_tx_parameters {
u8 frame_format:4;
u8 fec_coding:1;
u8 short_gi:1;
u8 reserved1:1;
u8 stbc:1;
u8 reserved2;
u8 aggregation:1;
u8 reserved3:7;
u8 reserved4;
} __packed;
struct hif_req_tx {
u32 packet_id;
u8 max_tx_rate;
struct hif_queue queue_id;
struct hif_data_flags data_flags;
struct hif_tx_flags tx_flags;
u32 reserved;
u32 expire_time;
struct hif_ht_tx_parameters ht_tx_parameters;
u8 frame[];
} __packed;
enum hif_qos_ackplcy {
HIF_QOS_ACKPLCY_NORMAL = 0x0,
HIF_QOS_ACKPLCY_TXNOACK = 0x1,
HIF_QOS_ACKPLCY_NOEXPACK = 0x2,
HIF_QOS_ACKPLCY_BLCKACK = 0x3
};
struct hif_tx_result_flags {
u8 aggr:1;
u8 requeue:1;
u8 ack_policy:2;
u8 txop_limit:1;
u8 reserved1:3;
u8 reserved2;
} __packed;
struct hif_cnf_tx {
u32 status;
u32 packet_id;
u8 txed_rate;
u8 ack_failures;
struct hif_tx_result_flags tx_result_flags;
u32 media_delay;
u32 tx_queue_delay;
} __packed;
struct hif_cnf_multi_transmit {
u32 num_tx_confs;
struct hif_cnf_tx tx_conf_payload[];
} __packed;
enum hif_ri_flags_encrypt {
HIF_RI_FLAGS_UNENCRYPTED = 0x0,
HIF_RI_FLAGS_WEP_ENCRYPTED = 0x1,
HIF_RI_FLAGS_TKIP_ENCRYPTED = 0x2,
HIF_RI_FLAGS_AES_ENCRYPTED = 0x3,
HIF_RI_FLAGS_WAPI_ENCRYPTED = 0x4
};
struct hif_rx_flags {
u8 encryp:3;
u8 in_aggr:1;
u8 first_aggr:1;
u8 last_aggr:1;
u8 defrag:1;
u8 beacon:1;
u8 tim:1;
u8 bitmap:1;
u8 match_ssid:1;
u8 match_bssid:1;
u8 more:1;
u8 reserved1:1;
u8 ht:1;
u8 stbc:1;
u8 match_uc_addr:1;
u8 match_mc_addr:1;
u8 match_bc_addr:1;
u8 key_type:1;
u8 key_index:4;
u8 reserved2:1;
u8 peer_sta_id:4;
u8 reserved3:2;
u8 reserved4:1;
} __packed;
struct hif_ind_rx {
u32 status;
u16 channel_number;
u8 rxed_rate;
u8 rcpi_rssi;
struct hif_rx_flags rx_flags;
u8 frame[];
} __packed;
struct hif_req_edca_queue_params {
u8 queue_id;
u8 reserved1;
u8 aifsn;
u8 reserved2;
u16 cw_min;
u16 cw_max;
u16 tx_op_limit;
u16 allowed_medium_time;
u32 reserved3;
} __packed;
struct hif_cnf_edca_queue_params {
u32 status;
} __packed;
struct hif_join_flags {
u8 reserved1:2;
u8 force_no_beacon:1;
u8 force_with_ind:1;
u8 reserved2:4;
} __packed;
struct hif_req_join {
u8 infrastructure_bss_mode:1;
u8 reserved1:7;
u8 band;
u16 channel_number;
u8 bssid[ETH_ALEN];
u16 atim_window;
u8 short_preamble:1;
u8 reserved2:7;
u8 probe_for_join;
u8 reserved3;
struct hif_join_flags join_flags;
u32 ssid_length;
u8 ssid[HIF_API_SSID_SIZE];
u32 beacon_interval;
u32 basic_rate_set;
} __packed;
struct hif_cnf_join {
u32 status;
} __packed;
struct hif_ind_join_complete {
u32 status;
} __packed;
struct hif_bss_flags {
u8 lost_count_only:1;
u8 reserved:7;
} __packed;
struct hif_req_set_bss_params {
struct hif_bss_flags bss_flags;
u8 beacon_lost_count;
u16 aid;
u32 operational_rate_set;
} __packed;
struct hif_cnf_set_bss_params {
u32 status;
} __packed;
struct hif_pm_mode {
u8 enter_psm:1;
u8 reserved:6;
u8 fast_psm:1;
} __packed;
struct hif_req_set_pm_mode {
struct hif_pm_mode pm_mode;
u8 fast_psm_idle_period;
u8 ap_psm_change_period;
u8 min_auto_ps_poll_period;
} __packed;
struct hif_cnf_set_pm_mode {
u32 status;
} __packed;
struct hif_ind_set_pm_mode_cmpl {
u32 status;
u8 pm_mode;
u8 reserved[3];
} __packed;
struct hif_req_start {
u8 mode;
u8 band;
u16 channel_number;
u32 reserved1;
u32 beacon_interval;
u8 dtim_period;
u8 short_preamble:1;
u8 reserved2:7;
u8 reserved3;
u8 ssid_length;
u8 ssid[HIF_API_SSID_SIZE];
u32 basic_rate_set;
} __packed;
struct hif_cnf_start {
u32 status;
} __packed;
enum hif_beacon {
HIF_BEACON_STOP = 0x0,
HIF_BEACON_START = 0x1
};
struct hif_req_beacon_transmit {
u8 enable_beaconing;
u8 reserved[3];
} __packed;
struct hif_cnf_beacon_transmit {
u32 status;
} __packed;
enum hif_sta_map_direction {
HIF_STA_MAP = 0x0,
HIF_STA_UNMAP = 0x1
};
struct hif_map_link_flags {
u8 map_direction:1;
u8 mfpc:1;
u8 reserved:6;
} __packed;
struct hif_req_map_link {
u8 mac_addr[ETH_ALEN];
struct hif_map_link_flags map_link_flags;
u8 peer_sta_id;
} __packed;
struct hif_cnf_map_link {
u32 status;
} __packed;
struct hif_suspend_resume_flags {
u8 resume:1;
u8 reserved1:2;
u8 bc_mc_only:1;
u8 reserved2:4;
u8 reserved3;
} __packed;
struct hif_ind_suspend_resume_tx {
struct hif_suspend_resume_flags suspend_resume_flags;
u16 peer_sta_set;
} __packed;
#define MAX_KEY_ENTRIES 24
#define HIF_API_WEP_KEY_DATA_SIZE 16
#define HIF_API_TKIP_KEY_DATA_SIZE 16
#define HIF_API_RX_MIC_KEY_SIZE 8
#define HIF_API_TX_MIC_KEY_SIZE 8
#define HIF_API_AES_KEY_DATA_SIZE 16
#define HIF_API_WAPI_KEY_DATA_SIZE 16
#define HIF_API_MIC_KEY_DATA_SIZE 16
#define HIF_API_IGTK_KEY_DATA_SIZE 16
#define HIF_API_RX_SEQUENCE_COUNTER_SIZE 8
#define HIF_API_IPN_SIZE 8
enum hif_key_type {
HIF_KEY_TYPE_WEP_DEFAULT = 0x0,
HIF_KEY_TYPE_WEP_PAIRWISE = 0x1,
HIF_KEY_TYPE_TKIP_GROUP = 0x2,
HIF_KEY_TYPE_TKIP_PAIRWISE = 0x3,
HIF_KEY_TYPE_AES_GROUP = 0x4,
HIF_KEY_TYPE_AES_PAIRWISE = 0x5,
HIF_KEY_TYPE_WAPI_GROUP = 0x6,
HIF_KEY_TYPE_WAPI_PAIRWISE = 0x7,
HIF_KEY_TYPE_IGTK_GROUP = 0x8,
HIF_KEY_TYPE_NONE = 0x9
};
struct hif_wep_pairwise_key {
u8 peer_address[ETH_ALEN];
u8 reserved;
u8 key_length;
u8 key_data[HIF_API_WEP_KEY_DATA_SIZE];
} __packed;
struct hif_wep_group_key {
u8 key_id;
u8 key_length;
u8 reserved[2];
u8 key_data[HIF_API_WEP_KEY_DATA_SIZE];
} __packed;
struct hif_tkip_pairwise_key {
u8 peer_address[ETH_ALEN];
u8 reserved[2];
u8 tkip_key_data[HIF_API_TKIP_KEY_DATA_SIZE];
u8 rx_mic_key[HIF_API_RX_MIC_KEY_SIZE];
u8 tx_mic_key[HIF_API_TX_MIC_KEY_SIZE];
} __packed;
struct hif_tkip_group_key {
u8 tkip_key_data[HIF_API_TKIP_KEY_DATA_SIZE];
u8 rx_mic_key[HIF_API_RX_MIC_KEY_SIZE];
u8 key_id;
u8 reserved[3];
u8 rx_sequence_counter[HIF_API_RX_SEQUENCE_COUNTER_SIZE];
} __packed;
struct hif_aes_pairwise_key {
u8 peer_address[ETH_ALEN];
u8 reserved[2];
u8 aes_key_data[HIF_API_AES_KEY_DATA_SIZE];
} __packed;
struct hif_aes_group_key {
u8 aes_key_data[HIF_API_AES_KEY_DATA_SIZE];
u8 key_id;
u8 reserved[3];
u8 rx_sequence_counter[HIF_API_RX_SEQUENCE_COUNTER_SIZE];
} __packed;
struct hif_wapi_pairwise_key {
u8 peer_address[ETH_ALEN];
u8 key_id;
u8 reserved;
u8 wapi_key_data[HIF_API_WAPI_KEY_DATA_SIZE];
u8 mic_key_data[HIF_API_MIC_KEY_DATA_SIZE];
} __packed;
struct hif_wapi_group_key {
u8 wapi_key_data[HIF_API_WAPI_KEY_DATA_SIZE];
u8 mic_key_data[HIF_API_MIC_KEY_DATA_SIZE];
u8 key_id;
u8 reserved[3];
} __packed;
struct hif_igtk_group_key {
u8 igtk_key_data[HIF_API_IGTK_KEY_DATA_SIZE];
u8 key_id;
u8 reserved[3];
u8 ipn[HIF_API_IPN_SIZE];
} __packed;
union hif_privacy_key_data {
struct hif_wep_pairwise_key wep_pairwise_key;
struct hif_wep_group_key wep_group_key;
struct hif_tkip_pairwise_key tkip_pairwise_key;
struct hif_tkip_group_key tkip_group_key;
struct hif_aes_pairwise_key aes_pairwise_key;
struct hif_aes_group_key aes_group_key;
struct hif_wapi_pairwise_key wapi_pairwise_key;
struct hif_wapi_group_key wapi_group_key;
struct hif_igtk_group_key igtk_group_key;
};
struct hif_req_add_key {
u8 type;
u8 entry_index;
u8 int_id:2;
u8 reserved1:6;
u8 reserved2;
union hif_privacy_key_data key;
} __packed;
struct hif_cnf_add_key {
u32 status;
} __packed;
struct hif_req_remove_key {
u8 entry_index;
u8 reserved[3];
} __packed;
struct hif_cnf_remove_key {
u32 status;
} __packed;
enum hif_event_ind {
HIF_EVENT_IND_BSSLOST = 0x1,
HIF_EVENT_IND_BSSREGAINED = 0x2,
HIF_EVENT_IND_RCPI_RSSI = 0x3,
HIF_EVENT_IND_PS_MODE_ERROR = 0x4,
HIF_EVENT_IND_INACTIVITY = 0x5
};
enum hif_ps_mode_error {
HIF_PS_ERROR_NO_ERROR = 0,
HIF_PS_ERROR_AP_NOT_RESP_TO_POLL = 1,
HIF_PS_ERROR_AP_NOT_RESP_TO_UAPSD_TRIGGER = 2,
HIF_PS_ERROR_AP_SENT_UNICAST_IN_DOZE = 3,
HIF_PS_ERROR_AP_NO_DATA_AFTER_TIM = 4
};
union hif_event_data {
u8 rcpi_rssi;
u32 ps_mode_error;
u32 peer_sta_set;
};
struct hif_ind_event {
u32 event_id;
union hif_event_data event_data;
} __packed;
#endif
Reference in a new issue View git blame Copy permalink