1887 lines · c
1/* SPDX-License-Identifier: GPL-2.0+ */2/* Copyright (c) 2015-2016 Quantenna Communications. All rights reserved. */3 4#ifndef _QTN_QLINK_H_5#define _QTN_QLINK_H_6 7#include <linux/ieee80211.h>8 9#define QLINK_PROTO_VER_MAJOR_M 0xFFFF10#define QLINK_PROTO_VER_MAJOR_S 1611#define QLINK_PROTO_VER_MINOR_M 0xFFFF12#define QLINK_VER_MINOR(_ver) ((_ver) & QLINK_PROTO_VER_MINOR_M)13#define QLINK_VER_MAJOR(_ver) \14 (((_ver) >> QLINK_PROTO_VER_MAJOR_S) & QLINK_PROTO_VER_MAJOR_M)15#define QLINK_VER(_maj, _min) (((_maj) << QLINK_PROTO_VER_MAJOR_S) | (_min))16 17#define QLINK_PROTO_VER_MAJOR 1818#define QLINK_PROTO_VER_MINOR 119#define QLINK_PROTO_VER \20 QLINK_VER(QLINK_PROTO_VER_MAJOR, QLINK_PROTO_VER_MINOR)21 22#define QLINK_ALIGN 423 24#define QLINK_MACID_RSVD 0xFF25#define QLINK_VIFID_RSVD 0xFF26 27/* Common QLINK protocol messages definitions.28 */29 30/**31 * enum qlink_msg_type - QLINK message types32 *33 * Used to distinguish between message types of QLINK protocol.34 *35 * @QLINK_MSG_TYPE_CMD: Message is carrying data of a command sent from36 * driver to wireless hardware.37 * @QLINK_MSG_TYPE_CMDRSP: Message is carrying data of a response to a command.38 * Sent from wireless HW to driver in reply to previously issued command.39 * @QLINK_MSG_TYPE_EVENT: Data for an event originated in wireless hardware and40 * sent asynchronously to driver.41 */42enum qlink_msg_type {43 QLINK_MSG_TYPE_CMD = 1,44 QLINK_MSG_TYPE_CMDRSP = 2,45 QLINK_MSG_TYPE_EVENT = 346};47 48/**49 * struct qlink_msg_header - common QLINK protocol message header50 *51 * Portion of QLINK protocol header common for all message types.52 *53 * @type: Message type, one of &enum qlink_msg_type.54 * @len: Total length of message including all headers.55 */56struct qlink_msg_header {57 __le16 type;58 __le16 len;59} __packed;60 61/* Generic definitions of data and information carried in QLINK messages62 */63 64/**65 * enum qlink_hw_capab - device capabilities.66 *67 * @QLINK_HW_CAPAB_REG_UPDATE: device can update it's regulatory region.68 * @QLINK_HW_CAPAB_STA_INACT_TIMEOUT: device implements a logic to kick-out69 * associated STAs due to inactivity. Inactivity timeout period is taken70 * from QLINK_CMD_START_AP parameters.71 * @QLINK_HW_CAPAB_DFS_OFFLOAD: device implements DFS offload functionality72 * @QLINK_HW_CAPAB_SCAN_RANDOM_MAC_ADDR: device supports MAC Address73 * Randomization in probe requests.74 * @QLINK_HW_CAPAB_OBSS_SCAN: device can perform OBSS scanning.75 * @QLINK_HW_CAPAB_HW_BRIDGE: device has hardware switch capabilities.76 */77enum qlink_hw_capab {78 QLINK_HW_CAPAB_REG_UPDATE = 0,79 QLINK_HW_CAPAB_STA_INACT_TIMEOUT,80 QLINK_HW_CAPAB_DFS_OFFLOAD,81 QLINK_HW_CAPAB_SCAN_RANDOM_MAC_ADDR,82 QLINK_HW_CAPAB_PWR_MGMT,83 QLINK_HW_CAPAB_OBSS_SCAN,84 QLINK_HW_CAPAB_SCAN_DWELL,85 QLINK_HW_CAPAB_SAE,86 QLINK_HW_CAPAB_HW_BRIDGE,87 QLINK_HW_CAPAB_NUM88};89 90/**91 * enum qlink_driver_capab - host driver capabilities.92 *93 */94enum qlink_driver_capab {95 QLINK_DRV_CAPAB_NUM = 096};97 98enum qlink_iface_type {99 QLINK_IFTYPE_AP = 1,100 QLINK_IFTYPE_STATION = 2,101 QLINK_IFTYPE_ADHOC = 3,102 QLINK_IFTYPE_MONITOR = 4,103 QLINK_IFTYPE_WDS = 5,104 QLINK_IFTYPE_AP_VLAN = 6,105};106 107/**108 * struct qlink_intf_info - information on virtual interface.109 *110 * Data describing a single virtual interface.111 *112 * @if_type: Mode of interface operation, one of &enum qlink_iface_type113 * @vlanid: VLAN ID for AP_VLAN interface type114 * @mac_addr: MAC address of virtual interface.115 */116struct qlink_intf_info {117 __le16 if_type;118 __le16 vlanid;119 u8 mac_addr[ETH_ALEN];120 u8 use4addr;121 u8 rsvd[1];122} __packed;123 124enum qlink_sta_flags {125 QLINK_STA_FLAG_INVALID = 0,126 QLINK_STA_FLAG_AUTHORIZED = BIT(0),127 QLINK_STA_FLAG_SHORT_PREAMBLE = BIT(1),128 QLINK_STA_FLAG_WME = BIT(2),129 QLINK_STA_FLAG_MFP = BIT(3),130 QLINK_STA_FLAG_AUTHENTICATED = BIT(4),131 QLINK_STA_FLAG_TDLS_PEER = BIT(5),132 QLINK_STA_FLAG_ASSOCIATED = BIT(6),133};134 135enum qlink_channel_width {136 QLINK_CHAN_WIDTH_5 = 0,137 QLINK_CHAN_WIDTH_10,138 QLINK_CHAN_WIDTH_20_NOHT,139 QLINK_CHAN_WIDTH_20,140 QLINK_CHAN_WIDTH_40,141 QLINK_CHAN_WIDTH_80,142 QLINK_CHAN_WIDTH_80P80,143 QLINK_CHAN_WIDTH_160,144};145 146/**147 * struct qlink_channel - qlink control channel definition148 *149 * @hw_value: hardware-specific value for the channel150 * @center_freq: center frequency in MHz151 * @flags: channel flags from &enum qlink_channel_flags152 * @band: band this channel belongs to153 * @max_antenna_gain: maximum antenna gain in dBi154 * @max_power: maximum transmission power (in dBm)155 * @max_reg_power: maximum regulatory transmission power (in dBm)156 * @dfs_state: current state of this channel.157 * Only relevant if radar is required on this channel.158 * @beacon_found: helper to regulatory code to indicate when a beacon159 * has been found on this channel. Use regulatory_hint_found_beacon()160 * to enable this, this is useful only on 5 GHz band.161 */162struct qlink_channel {163 __le16 hw_value;164 __le16 center_freq;165 __le32 flags;166 u8 band;167 u8 max_antenna_gain;168 u8 max_power;169 u8 max_reg_power;170 __le32 dfs_cac_ms;171 u8 dfs_state;172 u8 beacon_found;173 u8 rsvd[2];174} __packed;175 176/**177 * struct qlink_chandef - qlink channel definition178 *179 * @chan: primary channel definition180 * @center_freq1: center frequency of first segment181 * @center_freq2: center frequency of second segment (80+80 only)182 * @width: channel width, one of @enum qlink_channel_width183 */184struct qlink_chandef {185 struct qlink_channel chan;186 __le16 center_freq1;187 __le16 center_freq2;188 u8 width;189 u8 rsvd[3];190} __packed;191 192#define QLINK_MAX_NR_CIPHER_SUITES 5193#define QLINK_MAX_NR_AKM_SUITES 2194 195struct qlink_auth_encr {196 __le32 wpa_versions;197 __le32 cipher_group;198 __le32 n_ciphers_pairwise;199 __le32 ciphers_pairwise[QLINK_MAX_NR_CIPHER_SUITES];200 __le32 n_akm_suites;201 __le32 akm_suites[QLINK_MAX_NR_AKM_SUITES];202 __le16 control_port_ethertype;203 u8 auth_type;204 u8 privacy;205 u8 control_port;206 u8 control_port_no_encrypt;207 u8 rsvd[2];208} __packed;209 210/**211 * struct qlink_sta_info_state - station flags mask/value212 *213 * @mask: STA flags mask, bitmap of &enum qlink_sta_flags214 * @value: STA flags values, bitmap of &enum qlink_sta_flags215 */216struct qlink_sta_info_state {217 __le32 mask;218 __le32 value;219} __packed;220 221/**222 * enum qlink_sr_ctrl_flags - control flags for spatial reuse parameter set223 *224 * @QLINK_SR_PSR_DISALLOWED: indicates whether or not PSR-based spatial reuse225 * transmissions are allowed for STAs associated with the AP226 * @QLINK_SR_NON_SRG_OBSS_PD_SR_DISALLOWED: indicates whether or not227 * Non-SRG OBSS PD spatial reuse transmissions are allowed for STAs associated228 * with the AP229 * @NON_SRG_OFFSET_PRESENT: indicates whether or not Non-SRG OBSS PD Max offset230 * field is valid in the element231 * @QLINK_SR_SRG_INFORMATION_PRESENT: indicates whether or not SRG OBSS PD232 * Min/Max offset fields ore valid in the element233 */234enum qlink_sr_ctrl_flags {235 QLINK_SR_PSR_DISALLOWED = BIT(0),236 QLINK_SR_NON_SRG_OBSS_PD_SR_DISALLOWED = BIT(1),237 QLINK_SR_NON_SRG_OFFSET_PRESENT = BIT(2),238 QLINK_SR_SRG_INFORMATION_PRESENT = BIT(3),239};240 241/**242 * struct qlink_sr_params - spatial reuse parameters243 *244 * @sr_control: spatial reuse control field; flags contained in this field are245 * defined in @qlink_sr_ctrl_flags246 * @non_srg_obss_pd_max: added to -82 dBm to generate the value of the247 * Non-SRG OBSS PD Max parameter248 * @srg_obss_pd_min_offset: added to -82 dBm to generate the value of the249 * SRG OBSS PD Min parameter250 * @srg_obss_pd_max_offset: added to -82 dBm to generate the value of the251 * SRG PBSS PD Max parameter252 */253struct qlink_sr_params {254 u8 sr_control;255 u8 non_srg_obss_pd_max;256 u8 srg_obss_pd_min_offset;257 u8 srg_obss_pd_max_offset;258} __packed;259 260/* QLINK Command messages related definitions261 */262 263/**264 * enum qlink_cmd_type - list of supported commands265 *266 * Commands are QLINK messages of type @QLINK_MSG_TYPE_CMD, sent by driver to267 * wireless network device for processing. Device is expected to send back a268 * reply message of type &QLINK_MSG_TYPE_CMDRSP, containing at least command269 * execution status (one of &enum qlink_cmd_result). Reply message270 * may also contain data payload specific to the command type.271 *272 * @QLINK_CMD_SEND_FRAME: send specified frame over the air; firmware will273 * encapsulate 802.3 packet into 802.11 frame automatically.274 * @QLINK_CMD_BAND_INFO_GET: for the specified MAC and specified band, get275 * the band's description including number of operational channels and276 * info on each channel, HT/VHT capabilities, supported rates etc.277 * This command is generic to a specified MAC, interface index must be set278 * to QLINK_VIFID_RSVD in command header.279 * @QLINK_CMD_REG_NOTIFY: notify device about regulatory domain change. This280 * command is supported only if device reports QLINK_HW_SUPPORTS_REG_UPDATE281 * capability.282 * @QLINK_CMD_START_CAC: start radar detection procedure on a specified channel.283 * @QLINK_CMD_TXPWR: get or set current channel transmit power for284 * the specified MAC.285 * @QLINK_CMD_NDEV_EVENT: signalizes changes made with a corresponding network286 * device.287 */288enum qlink_cmd_type {289 QLINK_CMD_FW_INIT = 0x0001,290 QLINK_CMD_FW_DEINIT = 0x0002,291 QLINK_CMD_REGISTER_MGMT = 0x0003,292 QLINK_CMD_SEND_FRAME = 0x0004,293 QLINK_CMD_MGMT_SET_APPIE = 0x0005,294 QLINK_CMD_PHY_PARAMS_SET = 0x0012,295 QLINK_CMD_GET_HW_INFO = 0x0013,296 QLINK_CMD_MAC_INFO = 0x0014,297 QLINK_CMD_ADD_INTF = 0x0015,298 QLINK_CMD_DEL_INTF = 0x0016,299 QLINK_CMD_CHANGE_INTF = 0x0017,300 QLINK_CMD_UPDOWN_INTF = 0x0018,301 QLINK_CMD_REG_NOTIFY = 0x0019,302 QLINK_CMD_BAND_INFO_GET = 0x001A,303 QLINK_CMD_CHAN_SWITCH = 0x001B,304 QLINK_CMD_CHAN_GET = 0x001C,305 QLINK_CMD_START_CAC = 0x001D,306 QLINK_CMD_START_AP = 0x0021,307 QLINK_CMD_STOP_AP = 0x0022,308 QLINK_CMD_SET_MAC_ACL = 0x0023,309 QLINK_CMD_GET_STA_INFO = 0x0030,310 QLINK_CMD_ADD_KEY = 0x0040,311 QLINK_CMD_DEL_KEY = 0x0041,312 QLINK_CMD_SET_DEFAULT_KEY = 0x0042,313 QLINK_CMD_SET_DEFAULT_MGMT_KEY = 0x0043,314 QLINK_CMD_CHANGE_STA = 0x0051,315 QLINK_CMD_DEL_STA = 0x0052,316 QLINK_CMD_SCAN = 0x0053,317 QLINK_CMD_CHAN_STATS = 0x0054,318 QLINK_CMD_NDEV_EVENT = 0x0055,319 QLINK_CMD_CONNECT = 0x0060,320 QLINK_CMD_DISCONNECT = 0x0061,321 QLINK_CMD_PM_SET = 0x0062,322 QLINK_CMD_WOWLAN_SET = 0x0063,323 QLINK_CMD_EXTERNAL_AUTH = 0x0066,324 QLINK_CMD_TXPWR = 0x0067,325 QLINK_CMD_UPDATE_OWE = 0x0068,326};327 328/**329 * struct qlink_cmd - QLINK command message header330 *331 * Header used for QLINK messages of QLINK_MSG_TYPE_CMD type.332 *333 * @mhdr: Common QLINK message header.334 * @cmd_id: command id, one of &enum qlink_cmd_type.335 * @seq_num: sequence number of command message, used for matching with336 * response message.337 * @macid: index of physical radio device the command is destined to or338 * QLINK_MACID_RSVD if not applicable.339 * @vifid: index of virtual wireless interface on specified @macid the command340 * is destined to or QLINK_VIFID_RSVD if not applicable.341 */342struct qlink_cmd {343 struct qlink_msg_header mhdr;344 __le16 cmd_id;345 __le16 seq_num;346 u8 macid;347 u8 vifid;348 u8 rsvd[2];349} __packed;350 351/**352 * struct qlink_cmd_init_fw - data for QLINK_CMD_FW_INIT353 *354 * Initialize firmware based on specified host configuration. This is the first355 * command sent to wifi card and it's fixed part should never be changed, any356 * additions must be done by appending TLVs.357 * If wifi card can not operate with a specified parameters it will return358 * error.359 *360 * @qlink_proto_ver: QLINK protocol version used by host driver.361 */362struct qlink_cmd_init_fw {363 struct qlink_cmd chdr;364 __le32 qlink_proto_ver;365 u8 var_info[];366} __packed;367 368/**369 * struct qlink_cmd_manage_intf - interface management command370 *371 * Data for interface management commands QLINK_CMD_ADD_INTF, QLINK_CMD_DEL_INTF372 * and QLINK_CMD_CHANGE_INTF.373 *374 * @intf_info: interface description.375 */376struct qlink_cmd_manage_intf {377 struct qlink_cmd chdr;378 struct qlink_intf_info intf_info;379} __packed;380 381enum qlink_mgmt_frame_type {382 QLINK_MGMT_FRAME_ASSOC_REQ = 0x00,383 QLINK_MGMT_FRAME_ASSOC_RESP = 0x01,384 QLINK_MGMT_FRAME_REASSOC_REQ = 0x02,385 QLINK_MGMT_FRAME_REASSOC_RESP = 0x03,386 QLINK_MGMT_FRAME_PROBE_REQ = 0x04,387 QLINK_MGMT_FRAME_PROBE_RESP = 0x05,388 QLINK_MGMT_FRAME_BEACON = 0x06,389 QLINK_MGMT_FRAME_ATIM = 0x07,390 QLINK_MGMT_FRAME_DISASSOC = 0x08,391 QLINK_MGMT_FRAME_AUTH = 0x09,392 QLINK_MGMT_FRAME_DEAUTH = 0x0A,393 QLINK_MGMT_FRAME_ACTION = 0x0B,394 395 QLINK_MGMT_FRAME_TYPE_COUNT396};397 398/**399 * struct qlink_cmd_mgmt_frame_register - data for QLINK_CMD_REGISTER_MGMT400 *401 * @frame_type: MGMT frame type the registration request describes, one of402 * &enum qlink_mgmt_frame_type.403 * @do_register: 0 - unregister, otherwise register for reception of specified404 * MGMT frame type.405 */406struct qlink_cmd_mgmt_frame_register {407 struct qlink_cmd chdr;408 __le16 frame_type;409 u8 do_register;410 u8 rsvd[1];411} __packed;412 413/**414 * @QLINK_FRAME_TX_FLAG_8023: frame has a 802.3 header; if not set, frame415 * is a 802.11 encapsulated.416 */417enum qlink_frame_tx_flags {418 QLINK_FRAME_TX_FLAG_OFFCHAN = BIT(0),419 QLINK_FRAME_TX_FLAG_NO_CCK = BIT(1),420 QLINK_FRAME_TX_FLAG_ACK_NOWAIT = BIT(2),421 QLINK_FRAME_TX_FLAG_8023 = BIT(3),422};423 424/**425 * struct qlink_cmd_frame_tx - data for QLINK_CMD_SEND_FRAME command426 *427 * @cookie: opaque request identifier.428 * @freq: Frequency to use for frame transmission.429 * @flags: Transmission flags, one of &enum qlink_frame_tx_flags.430 * @frame_data: frame to transmit.431 */432struct qlink_cmd_frame_tx {433 struct qlink_cmd chdr;434 __le32 cookie;435 __le16 freq;436 __le16 flags;437 u8 frame_data[];438} __packed;439 440/**441 * struct qlink_cmd_get_sta_info - data for QLINK_CMD_GET_STA_INFO command442 *443 * @sta_addr: MAC address of the STA statistics is requested for.444 */445struct qlink_cmd_get_sta_info {446 struct qlink_cmd chdr;447 u8 sta_addr[ETH_ALEN];448 u8 rsvd[2];449} __packed;450 451/**452 * struct qlink_cmd_add_key - data for QLINK_CMD_ADD_KEY command.453 *454 * @key_index: index of the key being installed.455 * @pairwise: whether to use pairwise key.456 * @addr: MAC address of a STA key is being installed to.457 * @cipher: cipher suite.458 * @vlanid: VLAN ID for AP_VLAN interface type459 * @key_data: key data itself.460 */461struct qlink_cmd_add_key {462 struct qlink_cmd chdr;463 u8 key_index;464 u8 pairwise;465 u8 addr[ETH_ALEN];466 __le32 cipher;467 __le16 vlanid;468 u8 rsvd[2];469 u8 key_data[];470} __packed;471 472/**473 * struct qlink_cmd_del_key_req - data for QLINK_CMD_DEL_KEY command474 *475 * @key_index: index of the key being removed.476 * @pairwise: whether to use pairwise key.477 * @addr: MAC address of a STA for which a key is removed.478 */479struct qlink_cmd_del_key {480 struct qlink_cmd chdr;481 u8 key_index;482 u8 pairwise;483 u8 addr[ETH_ALEN];484} __packed;485 486/**487 * struct qlink_cmd_set_def_key - data for QLINK_CMD_SET_DEFAULT_KEY command488 *489 * @key_index: index of the key to be set as default one.490 * @unicast: key is unicast.491 * @multicast: key is multicast.492 */493struct qlink_cmd_set_def_key {494 struct qlink_cmd chdr;495 u8 key_index;496 u8 unicast;497 u8 multicast;498 u8 rsvd[1];499} __packed;500 501/**502 * struct qlink_cmd_set_def_mgmt_key - data for QLINK_CMD_SET_DEFAULT_MGMT_KEY503 *504 * @key_index: index of the key to be set as default MGMT key.505 */506struct qlink_cmd_set_def_mgmt_key {507 struct qlink_cmd chdr;508 u8 key_index;509 u8 rsvd[3];510} __packed;511 512/**513 * struct qlink_cmd_change_sta - data for QLINK_CMD_CHANGE_STA command514 *515 * @flag_update: STA flags to update516 * @if_type: Mode of interface operation, one of &enum qlink_iface_type517 * @vlanid: VLAN ID to assign to specific STA518 * @sta_addr: address of the STA for which parameters are set.519 */520struct qlink_cmd_change_sta {521 struct qlink_cmd chdr;522 struct qlink_sta_info_state flag_update;523 __le16 if_type;524 __le16 vlanid;525 u8 sta_addr[ETH_ALEN];526 u8 rsvd[2];527} __packed;528 529/**530 * struct qlink_cmd_del_sta - data for QLINK_CMD_DEL_STA command.531 *532 * See &struct station_del_parameters533 */534struct qlink_cmd_del_sta {535 struct qlink_cmd chdr;536 __le16 reason_code;537 u8 sta_addr[ETH_ALEN];538 u8 subtype;539 u8 rsvd[3];540} __packed;541 542enum qlink_sta_connect_flags {543 QLINK_STA_CONNECT_DISABLE_HT = BIT(0),544 QLINK_STA_CONNECT_DISABLE_VHT = BIT(1),545 QLINK_STA_CONNECT_USE_RRM = BIT(2),546};547 548/**549 * struct qlink_cmd_connect - data for QLINK_CMD_CONNECT command550 *551 * @bssid: BSSID of the BSS to connect to.552 * @bssid_hint: recommended AP BSSID for initial connection to the BSS or553 * 00:00:00:00:00:00 if not specified.554 * @prev_bssid: previous BSSID, if specified (not 00:00:00:00:00:00) indicates555 * a request to reassociate.556 * @bg_scan_period: period of background scan.557 * @flags: one of &enum qlink_sta_connect_flags.558 * @ht_capa: HT Capabilities overrides.559 * @ht_capa_mask: The bits of ht_capa which are to be used.560 * @vht_capa: VHT Capability overrides561 * @vht_capa_mask: The bits of vht_capa which are to be used.562 * @aen: authentication information.563 * @mfp: whether to use management frame protection.564 * @payload: variable portion of connection request.565 */566struct qlink_cmd_connect {567 struct qlink_cmd chdr;568 u8 bssid[ETH_ALEN];569 u8 bssid_hint[ETH_ALEN];570 u8 prev_bssid[ETH_ALEN];571 __le16 bg_scan_period;572 __le32 flags;573 struct ieee80211_ht_cap ht_capa;574 struct ieee80211_ht_cap ht_capa_mask;575 struct ieee80211_vht_cap vht_capa;576 struct ieee80211_vht_cap vht_capa_mask;577 struct qlink_auth_encr aen;578 u8 mfp;579 u8 pbss;580 u8 rsvd[2];581 u8 payload[];582} __packed;583 584/**585 * struct qlink_cmd_external_auth - data for QLINK_CMD_EXTERNAL_AUTH command586 *587 * @bssid: BSSID of the BSS to connect to588 * @status: authentication status code589 * @payload: variable portion of connection request.590 */591struct qlink_cmd_external_auth {592 struct qlink_cmd chdr;593 u8 peer[ETH_ALEN];594 __le16 status;595 u8 payload[];596} __packed;597 598/**599 * struct qlink_cmd_disconnect - data for QLINK_CMD_DISCONNECT command600 *601 * @reason: code of the reason of disconnect, see &enum ieee80211_reasoncode.602 */603struct qlink_cmd_disconnect {604 struct qlink_cmd chdr;605 __le16 reason;606 u8 rsvd[2];607} __packed;608 609/**610 * struct qlink_cmd_updown - data for QLINK_CMD_UPDOWN_INTF command611 *612 * @if_up: bring specified interface DOWN (if_up==0) or UP (otherwise).613 * Interface is specified in common command header @chdr.614 */615struct qlink_cmd_updown {616 struct qlink_cmd chdr;617 u8 if_up;618 u8 rsvd[3];619} __packed;620 621/**622 * enum qlink_band - a list of frequency bands623 *624 * @QLINK_BAND_2GHZ: 2.4GHz band625 * @QLINK_BAND_5GHZ: 5GHz band626 * @QLINK_BAND_60GHZ: 60GHz band627 */628enum qlink_band {629 QLINK_BAND_2GHZ = BIT(0),630 QLINK_BAND_5GHZ = BIT(1),631 QLINK_BAND_60GHZ = BIT(2),632};633 634/**635 * struct qlink_cmd_band_info_get - data for QLINK_CMD_BAND_INFO_GET command636 *637 * @band: a PHY band for which information is queried, one of @enum qlink_band638 */639struct qlink_cmd_band_info_get {640 struct qlink_cmd chdr;641 u8 band;642 u8 rsvd[3];643} __packed;644 645/**646 * struct qlink_cmd_get_chan_stats - data for QLINK_CMD_CHAN_STATS command647 *648 * @channel_freq: channel center frequency649 */650struct qlink_cmd_get_chan_stats {651 struct qlink_cmd chdr;652 __le32 channel_freq;653} __packed;654 655/**656 * enum qlink_reg_initiator - Indicates the initiator of a reg domain request657 *658 * See &enum nl80211_reg_initiator for more info.659 */660enum qlink_reg_initiator {661 QLINK_REGDOM_SET_BY_CORE,662 QLINK_REGDOM_SET_BY_USER,663 QLINK_REGDOM_SET_BY_DRIVER,664 QLINK_REGDOM_SET_BY_COUNTRY_IE,665};666 667/**668 * enum qlink_user_reg_hint_type - type of user regulatory hint669 *670 * See &enum nl80211_user_reg_hint_type for more info.671 */672enum qlink_user_reg_hint_type {673 QLINK_USER_REG_HINT_USER = 0,674 QLINK_USER_REG_HINT_CELL_BASE = 1,675 QLINK_USER_REG_HINT_INDOOR = 2,676};677 678/**679 * struct qlink_cmd_reg_notify - data for QLINK_CMD_REG_NOTIFY command680 *681 * @alpha2: the ISO / IEC 3166 alpha2 country code.682 * @initiator: which entity sent the request, one of &enum qlink_reg_initiator.683 * @user_reg_hint_type: type of hint for QLINK_REGDOM_SET_BY_USER request, one684 * of &enum qlink_user_reg_hint_type.685 * @num_channels: number of &struct qlink_tlv_channel in a variable portion of a686 * payload.687 * @dfs_region: one of &enum qlink_dfs_regions.688 * @slave_radar: whether slave device should enable radar detection.689 * @dfs_offload: enable or disable DFS offload to firmware.690 * @info: variable portion of regulatory notifier callback.691 */692struct qlink_cmd_reg_notify {693 struct qlink_cmd chdr;694 u8 alpha2[2];695 u8 initiator;696 u8 user_reg_hint_type;697 u8 num_channels;698 u8 dfs_region;699 u8 slave_radar;700 u8 dfs_offload;701 u8 info[];702} __packed;703 704/**705 * enum qlink_chan_sw_flags - channel switch control flags706 *707 * @QLINK_CHAN_SW_RADAR_REQUIRED: whether radar detection is required on a new708 * channel.709 * @QLINK_CHAN_SW_BLOCK_TX: whether transmissions should be blocked while710 * changing a channel.711 */712enum qlink_chan_sw_flags {713 QLINK_CHAN_SW_RADAR_REQUIRED = BIT(0),714 QLINK_CHAN_SW_BLOCK_TX = BIT(1),715};716 717/**718 * struct qlink_cmd_chan_switch - data for QLINK_CMD_CHAN_SWITCH command719 *720 * @channel: channel to switch to.721 * @flags: flags to control channel switch, bitmap of &enum qlink_chan_sw_flags.722 * @beacon_count: number of beacons until switch723 */724struct qlink_cmd_chan_switch {725 struct qlink_cmd chdr;726 struct qlink_chandef channel;727 __le64 flags;728 __le32 n_counter_offsets_beacon;729 __le32 n_counter_offsets_presp;730 u8 beacon_count;731 u8 rsvd[3];732} __packed;733 734/**735 * enum qlink_hidden_ssid - values for %NL80211_ATTR_HIDDEN_SSID736 *737 * Refer to &enum nl80211_hidden_ssid738 */739enum qlink_hidden_ssid {740 QLINK_HIDDEN_SSID_NOT_IN_USE,741 QLINK_HIDDEN_SSID_ZERO_LEN,742 QLINK_HIDDEN_SSID_ZERO_CONTENTS743};744 745/**746 * struct qlink_cmd_start_ap - data for QLINK_CMD_START_AP command747 *748 * @beacon_interval: beacon interval749 * @inactivity_timeout: station's inactivity period in seconds750 * @dtim_period: DTIM period751 * @hidden_ssid: whether to hide the SSID, one of &enum qlink_hidden_ssid752 * @smps_mode: SMPS mode753 * @ht_required: stations must support HT754 * @vht_required: stations must support VHT755 * @aen: encryption info756 * @sr_params: spatial reuse parameters757 * @twt_responder: enable Target Wake Time758 * @info: variable configurations759 */760struct qlink_cmd_start_ap {761 struct qlink_cmd chdr;762 __le16 beacon_interval;763 __le16 inactivity_timeout;764 u8 dtim_period;765 u8 hidden_ssid;766 u8 smps_mode;767 u8 p2p_ctwindow;768 u8 p2p_opp_ps;769 u8 pbss;770 u8 ht_required;771 u8 vht_required;772 struct qlink_auth_encr aen;773 struct qlink_sr_params sr_params;774 u8 twt_responder;775 u8 rsvd[3];776 u8 info[];777} __packed;778 779/**780 * struct qlink_cmd_start_cac - data for QLINK_CMD_START_CAC command781 *782 * @chan: a channel to start a radar detection procedure on.783 * @cac_time_ms: CAC time.784 */785struct qlink_cmd_start_cac {786 struct qlink_cmd chdr;787 struct qlink_chandef chan;788 __le32 cac_time_ms;789} __packed;790 791enum qlink_acl_policy {792 QLINK_ACL_POLICY_ACCEPT_UNLESS_LISTED,793 QLINK_ACL_POLICY_DENY_UNLESS_LISTED,794};795 796struct qlink_mac_address {797 u8 addr[ETH_ALEN];798} __packed;799 800/**801 * struct qlink_acl_data - ACL data802 *803 * @policy: filter policy, one of &enum qlink_acl_policy.804 * @num_entries: number of MAC addresses in array.805 * @mac_address: MAC addresses array.806 */807struct qlink_acl_data {808 __le32 policy;809 __le32 num_entries;810 struct qlink_mac_address mac_addrs[];811} __packed;812 813/**814 * enum qlink_pm_mode - Power Management mode815 *816 * @QLINK_PM_OFF: normal mode, no power saving enabled817 * @QLINK_PM_AUTO_STANDBY: enable auto power save mode818 */819enum qlink_pm_mode {820 QLINK_PM_OFF = 0,821 QLINK_PM_AUTO_STANDBY = 1,822};823 824/**825 * struct qlink_cmd_pm_set - data for QLINK_CMD_PM_SET command826 *827 * @pm_standby timer: period of network inactivity in seconds before828 * putting a radio in power save mode829 * @pm_mode: power management mode830 */831struct qlink_cmd_pm_set {832 struct qlink_cmd chdr;833 __le32 pm_standby_timer;834 u8 pm_mode;835 u8 rsvd[3];836} __packed;837 838/**839 * enum qlink_txpwr_op - transmit power operation type840 * @QLINK_TXPWR_SET: set tx power841 * @QLINK_TXPWR_GET: get current tx power setting842 */843enum qlink_txpwr_op {844 QLINK_TXPWR_SET,845 QLINK_TXPWR_GET846};847 848/**849 * struct qlink_cmd_txpwr - get or set current transmit power850 *851 * @txpwr: new transmit power setting, in mBm852 * @txpwr_setting: transmit power setting type, one of853 * &enum nl80211_tx_power_setting854 * @op_type: type of operation, one of &enum qlink_txpwr_op855 */856struct qlink_cmd_txpwr {857 struct qlink_cmd chdr;858 __le32 txpwr;859 u8 txpwr_setting;860 u8 op_type;861 u8 rsvd[2];862} __packed;863 864/**865 * enum qlink_wowlan_trigger866 *867 * @QLINK_WOWLAN_TRIG_DISCONNECT: wakeup on disconnect868 * @QLINK_WOWLAN_TRIG_MAGIC_PKT: wakeup on magic packet869 * @QLINK_WOWLAN_TRIG_PATTERN_PKT: wakeup on user-defined packet870 */871enum qlink_wowlan_trigger {872 QLINK_WOWLAN_TRIG_DISCONNECT = BIT(0),873 QLINK_WOWLAN_TRIG_MAGIC_PKT = BIT(1),874 QLINK_WOWLAN_TRIG_PATTERN_PKT = BIT(2),875};876 877/**878 * struct qlink_cmd_wowlan_set - data for QLINK_CMD_WOWLAN_SET command879 *880 * @triggers: requested bitmask of WoWLAN triggers881 */882struct qlink_cmd_wowlan_set {883 struct qlink_cmd chdr;884 __le32 triggers;885 u8 data[];886} __packed;887 888enum qlink_ndev_event_type {889 QLINK_NDEV_EVENT_CHANGEUPPER,890};891 892/**893 * struct qlink_cmd_ndev_event - data for QLINK_CMD_NDEV_EVENT command894 *895 * @event: type of event, one of &enum qlink_ndev_event_type896 */897struct qlink_cmd_ndev_event {898 struct qlink_cmd chdr;899 __le16 event;900 u8 rsvd[2];901} __packed;902 903enum qlink_ndev_upper_type {904 QLINK_NDEV_UPPER_TYPE_NONE,905 QLINK_NDEV_UPPER_TYPE_BRIDGE,906};907 908/**909 * struct qlink_cmd_ndev_changeupper - data for QLINK_NDEV_EVENT_CHANGEUPPER910 *911 * @br_domain: layer 2 broadcast domain ID that ndev is a member of912 * @upper_type: type of upper device, one of &enum qlink_ndev_upper_type913 */914struct qlink_cmd_ndev_changeupper {915 struct qlink_cmd_ndev_event nehdr;916 __le64 flags;917 __le32 br_domain;918 __le32 netspace_id;919 __le16 vlanid;920 u8 upper_type;921 u8 rsvd[1];922} __packed;923 924/**925 * enum qlink_scan_flags - scan request control flags926 *927 * Scan flags are used to control QLINK_CMD_SCAN behavior.928 *929 * @QLINK_SCAN_FLAG_FLUSH: flush cache before scanning.930 */931enum qlink_scan_flags {932 QLINK_SCAN_FLAG_FLUSH = BIT(0),933 QLINK_SCAN_FLAG_DURATION_MANDATORY = BIT(1),934};935 936/**937 * struct qlink_cmd_scan - data for QLINK_CMD_SCAN command938 *939 * @flags: scan flags, a bitmap of &enum qlink_scan_flags.940 * @n_ssids: number of WLAN_EID_SSID TLVs expected in variable portion of the941 * command.942 * @n_channels: number of QTN_TLV_ID_CHANNEL TLVs expected in variable payload.943 * @active_dwell: time spent on a single channel for an active scan.944 * @passive_dwell: time spent on a single channel for a passive scan.945 * @sample_duration: total duration of sampling a single channel during a scan946 * including off-channel dwell time and operating channel time.947 * @bssid: specific BSSID to scan for or a broadcast BSSID.948 * @scan_width: channel width to use, one of &enum qlink_channel_width.949 */950struct qlink_cmd_scan {951 struct qlink_cmd chdr;952 __le64 flags;953 __le16 n_ssids;954 __le16 n_channels;955 __le16 active_dwell;956 __le16 passive_dwell;957 __le16 sample_duration;958 u8 bssid[ETH_ALEN];959 u8 scan_width;960 u8 rsvd[3];961 u8 var_info[];962} __packed;963 964/**965 * struct qlink_cmd_update_owe - data for QLINK_CMD_UPDATE_OWE_INFO command966 *967 * @peer: MAC of the peer device for which OWE processing has been completed968 * @status: OWE external processing status code969 * @ies: IEs for the peer constructed by the user space970 */971struct qlink_cmd_update_owe {972 struct qlink_cmd chdr;973 u8 peer[ETH_ALEN];974 __le16 status;975 u8 ies[];976} __packed;977 978/* QLINK Command Responses messages related definitions979 */980 981enum qlink_cmd_result {982 QLINK_CMD_RESULT_OK = 0,983 QLINK_CMD_RESULT_INVALID,984 QLINK_CMD_RESULT_ENOTSUPP,985 QLINK_CMD_RESULT_ENOTFOUND,986 QLINK_CMD_RESULT_EALREADY,987 QLINK_CMD_RESULT_EADDRINUSE,988 QLINK_CMD_RESULT_EADDRNOTAVAIL,989 QLINK_CMD_RESULT_EBUSY,990};991 992/**993 * struct qlink_resp - QLINK command response message header994 *995 * Header used for QLINK messages of QLINK_MSG_TYPE_CMDRSP type.996 *997 * @mhdr: see &struct qlink_msg_header.998 * @cmd_id: command ID the response corresponds to, one of &enum qlink_cmd_type.999 * @seq_num: sequence number of command message, used for matching with1000 * response message.1001 * @result: result of the command execution, one of &enum qlink_cmd_result.1002 * @macid: index of physical radio device the response is sent from or1003 * QLINK_MACID_RSVD if not applicable.1004 * @vifid: index of virtual wireless interface on specified @macid the response1005 * is sent from or QLINK_VIFID_RSVD if not applicable.1006 */1007struct qlink_resp {1008 struct qlink_msg_header mhdr;1009 __le16 cmd_id;1010 __le16 seq_num;1011 __le16 result;1012 u8 macid;1013 u8 vifid;1014} __packed;1015 1016/**1017 * struct qlink_resp_init_fw - response for QLINK_CMD_FW_INIT1018 *1019 * @qlink_proto_ver: QLINK protocol version used by wifi card firmware.1020 */1021struct qlink_resp_init_fw {1022 struct qlink_resp rhdr;1023 __le32 qlink_proto_ver;1024} __packed;1025 1026/**1027 * enum qlink_dfs_regions - regulatory DFS regions1028 *1029 * Corresponds to &enum nl80211_dfs_regions.1030 */1031enum qlink_dfs_regions {1032 QLINK_DFS_UNSET = 0,1033 QLINK_DFS_FCC = 1,1034 QLINK_DFS_ETSI = 2,1035 QLINK_DFS_JP = 3,1036};1037 1038/**1039 * struct qlink_resp_get_mac_info - response for QLINK_CMD_MAC_INFO command1040 *1041 * Data describing specific physical device providing wireless MAC1042 * functionality.1043 *1044 * @dev_mac: MAC address of physical WMAC device (used for first BSS on1045 * specified WMAC).1046 * @num_tx_chain: Number of transmit chains used by WMAC.1047 * @num_rx_chain: Number of receive chains used by WMAC.1048 * @vht_cap_mod_mask: mask specifying which VHT capabilities can be altered.1049 * @ht_cap_mod_mask: mask specifying which HT capabilities can be altered.1050 * @max_scan_ssids: maximum number of SSIDs the device can scan for in any scan.1051 * @bands_cap: wireless bands WMAC can operate in, bitmap of &enum qlink_band.1052 * @max_ap_assoc_sta: Maximum number of associations supported by WMAC.1053 * @radar_detect_widths: bitmask of channels BW for which WMAC can detect radar.1054 * @alpha2: country code ID firmware is configured to.1055 * @n_reg_rules: number of regulatory rules TLVs in variable portion of the1056 * message.1057 * @dfs_region: regulatory DFS region, one of &enum qlink_dfs_regions.1058 * @var_info: variable-length WMAC info data.1059 */1060struct qlink_resp_get_mac_info {1061 struct qlink_resp rhdr;1062 u8 dev_mac[ETH_ALEN];1063 u8 num_tx_chain;1064 u8 num_rx_chain;1065 struct ieee80211_vht_cap vht_cap_mod_mask;1066 struct ieee80211_ht_cap ht_cap_mod_mask;1067 1068 __le16 max_ap_assoc_sta;1069 __le32 hw_version;1070 __le32 probe_resp_offload;1071 __le32 bss_select_support;1072 __le16 n_addresses;1073 __le16 radar_detect_widths;1074 __le16 max_remain_on_channel_duration;1075 __le16 max_acl_mac_addrs;1076 1077 __le32 frag_threshold;1078 __le32 rts_threshold;1079 u8 retry_short;1080 u8 retry_long;1081 u8 coverage_class;1082 1083 u8 max_scan_ssids;1084 u8 max_sched_scan_reqs;1085 u8 max_sched_scan_ssids;1086 u8 max_match_sets;1087 u8 max_adj_channel_rssi_comp;1088 1089 __le16 max_scan_ie_len;1090 __le16 max_sched_scan_ie_len;1091 __le32 max_sched_scan_plans;1092 __le32 max_sched_scan_plan_interval;1093 __le32 max_sched_scan_plan_iterations;1094 1095 u8 n_cipher_suites;1096 u8 n_akm_suites;1097 u8 max_num_pmkids;1098 u8 num_iftype_ext_capab;1099 u8 extended_capabilities_len;1100 u8 max_data_retry_count;1101 u8 n_iface_combinations;1102 u8 max_num_csa_counters;1103 1104 u8 bands_cap;1105 u8 alpha2[2];1106 u8 n_reg_rules;1107 u8 dfs_region;1108 u8 rsvd[3];1109 u8 var_info[];1110} __packed;1111 1112/**1113 * struct qlink_resp_get_hw_info - response for QLINK_CMD_GET_HW_INFO command1114 *1115 * Description of wireless hardware capabilities and features.1116 *1117 * @fw_ver: wireless hardware firmware version.1118 * @num_mac: Number of separate physical radio devices provided by hardware.1119 * @mac_bitmap: Bitmap of MAC IDs that are active and can be used in firmware.1120 * @total_tx_chains: total number of transmit chains used by device.1121 * @total_rx_chains: total number of receive chains.1122 * @info: variable-length HW info.1123 */1124struct qlink_resp_get_hw_info {1125 struct qlink_resp rhdr;1126 __le32 fw_ver;1127 __le32 bld_tmstamp;1128 __le32 plat_id;1129 __le32 hw_ver;1130 u8 num_mac;1131 u8 mac_bitmap;1132 u8 total_tx_chain;1133 u8 total_rx_chain;1134 u8 info[];1135} __packed;1136 1137/**1138 * struct qlink_resp_manage_intf - response for interface management commands1139 *1140 * Response data for QLINK_CMD_ADD_INTF and QLINK_CMD_CHANGE_INTF commands.1141 *1142 * @rhdr: Common Command Response message header.1143 * @intf_info: interface description.1144 */1145struct qlink_resp_manage_intf {1146 struct qlink_resp rhdr;1147 struct qlink_intf_info intf_info;1148} __packed;1149 1150enum qlink_sta_info_rate_flags {1151 QLINK_STA_INFO_RATE_FLAG_HT_MCS = BIT(0),1152 QLINK_STA_INFO_RATE_FLAG_VHT_MCS = BIT(1),1153 QLINK_STA_INFO_RATE_FLAG_SHORT_GI = BIT(2),1154 QLINK_STA_INFO_RATE_FLAG_60G = BIT(3),1155 QLINK_STA_INFO_RATE_FLAG_HE_MCS = BIT(4),1156};1157 1158/**1159 * struct qlink_resp_get_sta_info - response for QLINK_CMD_GET_STA_INFO command1160 *1161 * Response data containing statistics for specified STA.1162 *1163 * @sta_addr: MAC address of STA the response carries statistic for.1164 * @info: variable statistics for specified STA.1165 */1166struct qlink_resp_get_sta_info {1167 struct qlink_resp rhdr;1168 u8 sta_addr[ETH_ALEN];1169 u8 rsvd[2];1170 u8 info[];1171} __packed;1172 1173/**1174 * struct qlink_resp_band_info_get - response for QLINK_CMD_BAND_INFO_GET cmd1175 *1176 * @band: frequency band that the response describes, one of @enum qlink_band.1177 * @num_chans: total number of channels info TLVs contained in reply.1178 * @num_bitrates: total number of bitrate TLVs contained in reply.1179 * @info: variable-length info portion.1180 */1181struct qlink_resp_band_info_get {1182 struct qlink_resp rhdr;1183 u8 band;1184 u8 num_chans;1185 u8 num_bitrates;1186 u8 rsvd[1];1187 u8 info[];1188} __packed;1189 1190/**1191 * struct qlink_resp_get_chan_stats - response for QLINK_CMD_CHAN_STATS cmd1192 *1193 * @chan_freq: center frequency for a channel the report is sent for.1194 * @info: variable-length channel info.1195 */1196struct qlink_resp_get_chan_stats {1197 struct qlink_resp rhdr;1198 __le32 chan_freq;1199 u8 info[];1200} __packed;1201 1202/**1203 * struct qlink_resp_channel_get - response for QLINK_CMD_CHAN_GET command1204 *1205 * @chan: definition of current operating channel.1206 */1207struct qlink_resp_channel_get {1208 struct qlink_resp rhdr;1209 struct qlink_chandef chan;1210} __packed;1211 1212/**1213 * struct qlink_resp_txpwr - response for QLINK_CMD_TXPWR command1214 *1215 * This response is intended for QLINK_TXPWR_GET operation and does not1216 * contain any meaningful information in case of QLINK_TXPWR_SET operation.1217 *1218 * @txpwr: current transmit power setting, in mBm1219 */1220struct qlink_resp_txpwr {1221 struct qlink_resp rhdr;1222 __le32 txpwr;1223} __packed;1224 1225/* QLINK Events messages related definitions1226 */1227 1228enum qlink_event_type {1229 QLINK_EVENT_STA_ASSOCIATED = 0x0021,1230 QLINK_EVENT_STA_DEAUTH = 0x0022,1231 QLINK_EVENT_MGMT_RECEIVED = 0x0023,1232 QLINK_EVENT_SCAN_RESULTS = 0x0024,1233 QLINK_EVENT_SCAN_COMPLETE = 0x0025,1234 QLINK_EVENT_BSS_JOIN = 0x0026,1235 QLINK_EVENT_BSS_LEAVE = 0x0027,1236 QLINK_EVENT_FREQ_CHANGE = 0x0028,1237 QLINK_EVENT_RADAR = 0x0029,1238 QLINK_EVENT_EXTERNAL_AUTH = 0x0030,1239 QLINK_EVENT_MIC_FAILURE = 0x0031,1240 QLINK_EVENT_UPDATE_OWE = 0x0032,1241};1242 1243/**1244 * struct qlink_event - QLINK event message header1245 *1246 * Header used for QLINK messages of QLINK_MSG_TYPE_EVENT type.1247 *1248 * @mhdr: Common QLINK message header.1249 * @event_id: Specifies specific event ID, one of &enum qlink_event_type.1250 * @macid: index of physical radio device the event was generated on or1251 * QLINK_MACID_RSVD if not applicable.1252 * @vifid: index of virtual wireless interface on specified @macid the event1253 * was generated on or QLINK_VIFID_RSVD if not applicable.1254 */1255struct qlink_event {1256 struct qlink_msg_header mhdr;1257 __le16 event_id;1258 u8 macid;1259 u8 vifid;1260} __packed;1261 1262/**1263 * struct qlink_event_sta_assoc - data for QLINK_EVENT_STA_ASSOCIATED event1264 *1265 * @sta_addr: Address of a STA for which new association event was generated1266 * @frame_control: control bits from 802.11 ASSOC_REQUEST header.1267 * @payload: IEs from association request.1268 */1269struct qlink_event_sta_assoc {1270 struct qlink_event ehdr;1271 u8 sta_addr[ETH_ALEN];1272 __le16 frame_control;1273 u8 ies[];1274} __packed;1275 1276/**1277 * struct qlink_event_sta_deauth - data for QLINK_EVENT_STA_DEAUTH event1278 *1279 * @sta_addr: Address of a deauthenticated STA.1280 * @reason: reason for deauthentication.1281 */1282struct qlink_event_sta_deauth {1283 struct qlink_event ehdr;1284 u8 sta_addr[ETH_ALEN];1285 __le16 reason;1286} __packed;1287 1288/**1289 * struct qlink_event_bss_join - data for QLINK_EVENT_BSS_JOIN event1290 *1291 * @chan: new operating channel definition1292 * @bssid: BSSID of a BSS which interface tried to joined.1293 * @status: status of joining attempt, see &enum ieee80211_statuscode.1294 */1295struct qlink_event_bss_join {1296 struct qlink_event ehdr;1297 struct qlink_chandef chan;1298 u8 bssid[ETH_ALEN];1299 __le16 status;1300 u8 ies[];1301} __packed;1302 1303/**1304 * struct qlink_event_bss_leave - data for QLINK_EVENT_BSS_LEAVE event1305 *1306 * @reason: reason of disconnecting from BSS.1307 */1308struct qlink_event_bss_leave {1309 struct qlink_event ehdr;1310 __le16 reason;1311 u8 rsvd[2];1312} __packed;1313 1314/**1315 * struct qlink_event_freq_change - data for QLINK_EVENT_FREQ_CHANGE event1316 *1317 * @chan: new operating channel definition1318 */1319struct qlink_event_freq_change {1320 struct qlink_event ehdr;1321 struct qlink_chandef chan;1322} __packed;1323 1324enum qlink_rxmgmt_flags {1325 QLINK_RXMGMT_FLAG_ANSWERED = 1 << 0,1326};1327 1328/**1329 * struct qlink_event_rxmgmt - data for QLINK_EVENT_MGMT_RECEIVED event1330 *1331 * @freq: Frequency on which the frame was received in MHz.1332 * @flags: bitmap of &enum qlink_rxmgmt_flags.1333 * @sig_dbm: signal strength in dBm.1334 * @frame_data: data of Rx'd frame itself.1335 */1336struct qlink_event_rxmgmt {1337 struct qlink_event ehdr;1338 __le32 freq;1339 __le32 flags;1340 s8 sig_dbm;1341 u8 rsvd[3];1342 u8 frame_data[];1343} __packed;1344 1345/**1346 * struct qlink_event_scan_result - data for QLINK_EVENT_SCAN_RESULTS event1347 *1348 * @tsf: TSF timestamp indicating when scan results were generated.1349 * @freq: Center frequency of the channel where BSS for which the scan result1350 * event was generated was discovered.1351 * @capab: capabilities field.1352 * @bintval: beacon interval announced by discovered BSS.1353 * @sig_dbm: signal strength in dBm.1354 * @bssid: BSSID announced by discovered BSS.1355 * @ssid_len: length of SSID announced by BSS.1356 * @ssid: SSID announced by discovered BSS.1357 * @payload: IEs that are announced by discovered BSS in its MGMt frames.1358 */1359struct qlink_event_scan_result {1360 struct qlink_event ehdr;1361 __le64 tsf;1362 __le16 freq;1363 __le16 capab;1364 __le16 bintval;1365 s8 sig_dbm;1366 u8 ssid_len;1367 u8 ssid[IEEE80211_MAX_SSID_LEN];1368 u8 bssid[ETH_ALEN];1369 u8 rsvd[2];1370 u8 payload[];1371} __packed;1372 1373/**1374 * enum qlink_scan_complete_flags - indicates result of scan request.1375 *1376 * @QLINK_SCAN_NONE: Scan request was processed.1377 * @QLINK_SCAN_ABORTED: Scan was aborted.1378 */1379enum qlink_scan_complete_flags {1380 QLINK_SCAN_NONE = 0,1381 QLINK_SCAN_ABORTED = BIT(0),1382};1383 1384/**1385 * struct qlink_event_scan_complete - data for QLINK_EVENT_SCAN_COMPLETE event1386 *1387 * @flags: flags indicating the status of pending scan request,1388 * see &enum qlink_scan_complete_flags.1389 */1390struct qlink_event_scan_complete {1391 struct qlink_event ehdr;1392 __le32 flags;1393} __packed;1394 1395enum qlink_radar_event {1396 QLINK_RADAR_DETECTED,1397 QLINK_RADAR_CAC_FINISHED,1398 QLINK_RADAR_CAC_ABORTED,1399 QLINK_RADAR_NOP_FINISHED,1400 QLINK_RADAR_PRE_CAC_EXPIRED,1401 QLINK_RADAR_CAC_STARTED,1402};1403 1404/**1405 * struct qlink_event_radar - data for QLINK_EVENT_RADAR event1406 *1407 * @chan: channel on which radar event happened.1408 * @event: radar event type, one of &enum qlink_radar_event.1409 */1410struct qlink_event_radar {1411 struct qlink_event ehdr;1412 struct qlink_chandef chan;1413 u8 event;1414 u8 rsvd[3];1415} __packed;1416 1417/**1418 * struct qlink_event_external_auth - data for QLINK_EVENT_EXTERNAL_AUTH event1419 *1420 * @ssid: SSID announced by BSS1421 * @ssid_len: SSID length1422 * @bssid: BSSID of the BSS to connect to1423 * @akm_suite: AKM suite for external authentication1424 * @action: action type/trigger for external authentication1425 */1426struct qlink_event_external_auth {1427 struct qlink_event ehdr;1428 __le32 akm_suite;1429 u8 ssid[IEEE80211_MAX_SSID_LEN];1430 u8 bssid[ETH_ALEN];1431 u8 ssid_len;1432 u8 action;1433} __packed;1434 1435/**1436 * struct qlink_event_mic_failure - data for QLINK_EVENT_MIC_FAILURE event1437 *1438 * @src: source MAC address of the frame1439 * @key_index: index of the key being reported1440 * @pairwise: whether the key is pairwise or group1441 */1442struct qlink_event_mic_failure {1443 struct qlink_event ehdr;1444 u8 src[ETH_ALEN];1445 u8 key_index;1446 u8 pairwise;1447} __packed;1448 1449/**1450 * struct qlink_event_update_owe - data for QLINK_EVENT_UPDATE_OWE event1451 *1452 * @peer: MAC addr of the peer device for which OWE processing needs to be done1453 * @ies: IEs from the peer1454 */1455struct qlink_event_update_owe {1456 struct qlink_event ehdr;1457 u8 peer[ETH_ALEN];1458 u8 rsvd[2];1459 u8 ies[];1460} __packed;1461 1462/* QLINK TLVs (Type-Length Values) definitions1463 */1464 1465/**1466 * enum qlink_tlv_id - list of TLVs that Qlink messages can carry1467 *1468 * @QTN_TLV_ID_BITMAP: a data representing a bitmap that is used together with1469 * other TLVs:1470 * &enum qlink_sta_info used to indicate which statistic carried in1471 * QTN_TLV_ID_STA_STATS is valid.1472 * &enum qlink_hw_capab listing wireless card capabilities.1473 * &enum qlink_driver_capab listing driver/host system capabilities.1474 * &enum qlink_chan_stat used to indicate which statistic carried in1475 * QTN_TLV_ID_CHANNEL_STATS is valid.1476 * @QTN_TLV_ID_STA_STATS: per-STA statistics as defined by1477 * &struct qlink_sta_stats. Valid values are marked as such in a bitmap1478 * carried by QTN_TLV_ID_BITMAP.1479 * @QTN_TLV_ID_IFTYPE_DATA: supported band data.1480 */1481enum qlink_tlv_id {1482 QTN_TLV_ID_FRAG_THRESH = 0x0201,1483 QTN_TLV_ID_RTS_THRESH = 0x0202,1484 QTN_TLV_ID_SRETRY_LIMIT = 0x0203,1485 QTN_TLV_ID_LRETRY_LIMIT = 0x0204,1486 QTN_TLV_ID_REG_RULE = 0x0207,1487 QTN_TLV_ID_CHANNEL = 0x020F,1488 QTN_TLV_ID_CHANDEF = 0x0210,1489 QTN_TLV_ID_BITMAP = 0x0211,1490 QTN_TLV_ID_STA_STATS = 0x0212,1491 QTN_TLV_ID_COVERAGE_CLASS = 0x0213,1492 QTN_TLV_ID_IFACE_LIMIT = 0x0214,1493 QTN_TLV_ID_CHANNEL_STATS = 0x0216,1494 QTN_TLV_ID_KEY = 0x0302,1495 QTN_TLV_ID_SEQ = 0x0303,1496 QTN_TLV_ID_IE_SET = 0x0305,1497 QTN_TLV_ID_EXT_CAPABILITY_MASK = 0x0306,1498 QTN_TLV_ID_ACL_DATA = 0x0307,1499 QTN_TLV_ID_BUILD_NAME = 0x0401,1500 QTN_TLV_ID_BUILD_REV = 0x0402,1501 QTN_TLV_ID_BUILD_TYPE = 0x0403,1502 QTN_TLV_ID_BUILD_LABEL = 0x0404,1503 QTN_TLV_ID_HW_ID = 0x0405,1504 QTN_TLV_ID_CALIBRATION_VER = 0x0406,1505 QTN_TLV_ID_UBOOT_VER = 0x0407,1506 QTN_TLV_ID_RANDOM_MAC_ADDR = 0x0408,1507 QTN_TLV_ID_WOWLAN_CAPAB = 0x0410,1508 QTN_TLV_ID_WOWLAN_PATTERN = 0x0411,1509 QTN_TLV_ID_IFTYPE_DATA = 0x0418,1510};1511 1512struct qlink_tlv_hdr {1513 __le16 type;1514 __le16 len;1515 u8 val[];1516} __packed;1517 1518struct qlink_iface_limit {1519 __le16 max_num;1520 __le16 type;1521} __packed;1522 1523struct qlink_iface_limit_record {1524 __le16 max_interfaces;1525 u8 num_different_channels;1526 u8 n_limits;1527 struct qlink_iface_limit limits[];1528} __packed;1529 1530#define QLINK_RSSI_OFFSET 1201531 1532/**1533 * enum qlink_reg_rule_flags - regulatory rule flags1534 *1535 * See description of &enum nl80211_reg_rule_flags1536 */1537enum qlink_reg_rule_flags {1538 QLINK_RRF_NO_OFDM = BIT(0),1539 QLINK_RRF_NO_CCK = BIT(1),1540 QLINK_RRF_NO_INDOOR = BIT(2),1541 QLINK_RRF_NO_OUTDOOR = BIT(3),1542 QLINK_RRF_DFS = BIT(4),1543 QLINK_RRF_PTP_ONLY = BIT(5),1544 QLINK_RRF_PTMP_ONLY = BIT(6),1545 QLINK_RRF_NO_IR = BIT(7),1546 QLINK_RRF_AUTO_BW = BIT(8),1547 QLINK_RRF_IR_CONCURRENT = BIT(9),1548 QLINK_RRF_NO_HT40MINUS = BIT(10),1549 QLINK_RRF_NO_HT40PLUS = BIT(11),1550 QLINK_RRF_NO_80MHZ = BIT(12),1551 QLINK_RRF_NO_160MHZ = BIT(13),1552};1553 1554/**1555 * struct qlink_tlv_reg_rule - data for QTN_TLV_ID_REG_RULE TLV1556 *1557 * Regulatory rule description.1558 *1559 * @start_freq_khz: start frequency of the range the rule is attributed to.1560 * @end_freq_khz: end frequency of the range the rule is attributed to.1561 * @max_bandwidth_khz: max bandwidth that channels in specified range can be1562 * configured to.1563 * @max_antenna_gain: max antenna gain that can be used in the specified1564 * frequency range, dBi.1565 * @max_eirp: maximum EIRP.1566 * @flags: regulatory rule flags in &enum qlink_reg_rule_flags.1567 * @dfs_cac_ms: DFS CAC period.1568 */1569struct qlink_tlv_reg_rule {1570 struct qlink_tlv_hdr hdr;1571 __le32 start_freq_khz;1572 __le32 end_freq_khz;1573 __le32 max_bandwidth_khz;1574 __le32 max_antenna_gain;1575 __le32 max_eirp;1576 __le32 flags;1577 __le32 dfs_cac_ms;1578} __packed;1579 1580enum qlink_channel_flags {1581 QLINK_CHAN_DISABLED = BIT(0),1582 QLINK_CHAN_NO_IR = BIT(1),1583 QLINK_CHAN_RADAR = BIT(3),1584 QLINK_CHAN_NO_HT40PLUS = BIT(4),1585 QLINK_CHAN_NO_HT40MINUS = BIT(5),1586 QLINK_CHAN_NO_OFDM = BIT(6),1587 QLINK_CHAN_NO_80MHZ = BIT(7),1588 QLINK_CHAN_NO_160MHZ = BIT(8),1589 QLINK_CHAN_INDOOR_ONLY = BIT(9),1590 QLINK_CHAN_IR_CONCURRENT = BIT(10),1591 QLINK_CHAN_NO_20MHZ = BIT(11),1592 QLINK_CHAN_NO_10MHZ = BIT(12),1593};1594 1595enum qlink_dfs_state {1596 QLINK_DFS_USABLE,1597 QLINK_DFS_UNAVAILABLE,1598 QLINK_DFS_AVAILABLE,1599};1600 1601/**1602 * struct qlink_tlv_channel - data for QTN_TLV_ID_CHANNEL TLV1603 *1604 * Channel settings.1605 *1606 * @channel: ieee80211 channel settings.1607 */1608struct qlink_tlv_channel {1609 struct qlink_tlv_hdr hdr;1610 struct qlink_channel chan;1611} __packed;1612 1613/**1614 * struct qlink_tlv_chandef - data for QTN_TLV_ID_CHANDEF TLV1615 *1616 * Channel definition.1617 *1618 * @chan: channel definition data.1619 */1620struct qlink_tlv_chandef {1621 struct qlink_tlv_hdr hdr;1622 struct qlink_chandef chdef;1623} __packed;1624 1625enum qlink_ie_set_type {1626 QLINK_IE_SET_UNKNOWN,1627 QLINK_IE_SET_ASSOC_REQ,1628 QLINK_IE_SET_ASSOC_RESP,1629 QLINK_IE_SET_PROBE_REQ,1630 QLINK_IE_SET_SCAN,1631 QLINK_IE_SET_BEACON_HEAD,1632 QLINK_IE_SET_BEACON_TAIL,1633 QLINK_IE_SET_BEACON_IES,1634 QLINK_IE_SET_PROBE_RESP,1635 QLINK_IE_SET_PROBE_RESP_IES,1636};1637 1638/**1639 * struct qlink_tlv_ie_set - data for QTN_TLV_ID_IE_SET1640 *1641 * @type: type of MGMT frame IEs belong to, one of &enum qlink_ie_set_type.1642 * @flags: for future use.1643 * @ie_data: IEs data.1644 */1645struct qlink_tlv_ie_set {1646 struct qlink_tlv_hdr hdr;1647 u8 type;1648 u8 flags;1649 u8 rsvd[2];1650 u8 ie_data[];1651} __packed;1652 1653/**1654 * struct qlink_tlv_ext_ie - extension IE1655 *1656 * @eid_ext: element ID extension, one of &enum ieee80211_eid_ext.1657 * @ie_data: IEs data.1658 */1659struct qlink_tlv_ext_ie {1660 struct qlink_tlv_hdr hdr;1661 u8 eid_ext;1662 u8 rsvd[3];1663 u8 ie_data[];1664} __packed;1665 1666#define IEEE80211_HE_PPE_THRES_MAX_LEN 251667struct qlink_sband_iftype_data {1668 __le16 types_mask;1669 struct ieee80211_he_cap_elem he_cap_elem;1670 struct ieee80211_he_mcs_nss_supp he_mcs_nss_supp;1671 u8 ppe_thres[IEEE80211_HE_PPE_THRES_MAX_LEN];1672} __packed;1673 1674/**1675 * struct qlink_tlv_iftype_data - data for QTN_TLV_ID_IFTYPE_DATA1676 *1677 * @n_iftype_data: number of entries in iftype_data.1678 * @iftype_data: interface type data entries.1679 */1680struct qlink_tlv_iftype_data {1681 struct qlink_tlv_hdr hdr;1682 u8 n_iftype_data;1683 u8 rsvd[3];1684 struct qlink_sband_iftype_data iftype_data[];1685} __packed;1686 1687/**1688 * enum qlink_chan_stat - channel statistics bitmap1689 *1690 * Used to indicate which statistics values in &struct qlink_chan_stats1691 * are valid. Individual values are used to fill a bitmap carried in a1692 * payload of QTN_TLV_ID_BITMAP.1693 *1694 * @QLINK_CHAN_STAT_TIME_ON: time_on value is valid.1695 * @QLINK_CHAN_STAT_TIME_TX: time_tx value is valid.1696 * @QLINK_CHAN_STAT_TIME_RX: time_rx value is valid.1697 * @QLINK_CHAN_STAT_CCA_BUSY: cca_busy value is valid.1698 * @QLINK_CHAN_STAT_CCA_BUSY_EXT: cca_busy_ext value is valid.1699 * @QLINK_CHAN_STAT_TIME_SCAN: time_scan value is valid.1700 * @QLINK_CHAN_STAT_CHAN_NOISE: chan_noise value is valid.1701 */1702enum qlink_chan_stat {1703 QLINK_CHAN_STAT_TIME_ON,1704 QLINK_CHAN_STAT_TIME_TX,1705 QLINK_CHAN_STAT_TIME_RX,1706 QLINK_CHAN_STAT_CCA_BUSY,1707 QLINK_CHAN_STAT_CCA_BUSY_EXT,1708 QLINK_CHAN_STAT_TIME_SCAN,1709 QLINK_CHAN_STAT_CHAN_NOISE,1710 QLINK_CHAN_STAT_NUM,1711};1712 1713/**1714 * struct qlink_chan_stats - data for QTN_TLV_ID_CHANNEL_STATS1715 *1716 * Carries a per-channel statistics. Not all fields may be filled with1717 * valid values. Valid fields should be indicated as such using a bitmap of1718 * &enum qlink_chan_stat. Bitmap is carried separately in a payload of1719 * QTN_TLV_ID_BITMAP.1720 *1721 * @time_on: amount of time radio operated on that channel.1722 * @time_tx: amount of time radio spent transmitting on the channel.1723 * @time_rx: amount of time radio spent receiving on the channel.1724 * @cca_busy: amount of time the primary channel was busy.1725 * @cca_busy_ext: amount of time the secondary channel was busy.1726 * @time_scan: amount of radio spent scanning on the channel.1727 * @chan_noise: channel noise.1728 */1729struct qlink_chan_stats {1730 __le64 time_on;1731 __le64 time_tx;1732 __le64 time_rx;1733 __le64 cca_busy;1734 __le64 cca_busy_ext;1735 __le64 time_scan;1736 s8 chan_noise;1737 u8 rsvd[3];1738} __packed;1739 1740/**1741 * enum qlink_sta_info - station information bitmap1742 *1743 * Used to indicate which statistics values in &struct qlink_sta_stats1744 * are valid. Individual values are used to fill a bitmap carried in a1745 * payload of QTN_TLV_ID_BITMAP.1746 *1747 * @QLINK_STA_INFO_CONNECTED_TIME: connected_time value is valid.1748 * @QLINK_STA_INFO_INACTIVE_TIME: inactive_time value is valid.1749 * @QLINK_STA_INFO_RX_BYTES: lower 32 bits of rx_bytes value are valid.1750 * @QLINK_STA_INFO_TX_BYTES: lower 32 bits of tx_bytes value are valid.1751 * @QLINK_STA_INFO_RX_BYTES64: rx_bytes value is valid.1752 * @QLINK_STA_INFO_TX_BYTES64: tx_bytes value is valid.1753 * @QLINK_STA_INFO_RX_DROP_MISC: rx_dropped_misc value is valid.1754 * @QLINK_STA_INFO_BEACON_RX: rx_beacon value is valid.1755 * @QLINK_STA_INFO_SIGNAL: signal value is valid.1756 * @QLINK_STA_INFO_SIGNAL_AVG: signal_avg value is valid.1757 * @QLINK_STA_INFO_RX_BITRATE: rxrate value is valid.1758 * @QLINK_STA_INFO_TX_BITRATE: txrate value is valid.1759 * @QLINK_STA_INFO_RX_PACKETS: rx_packets value is valid.1760 * @QLINK_STA_INFO_TX_PACKETS: tx_packets value is valid.1761 * @QLINK_STA_INFO_TX_RETRIES: tx_retries value is valid.1762 * @QLINK_STA_INFO_TX_FAILED: tx_failed value is valid.1763 * @QLINK_STA_INFO_STA_FLAGS: sta_flags value is valid.1764 */1765enum qlink_sta_info {1766 QLINK_STA_INFO_CONNECTED_TIME,1767 QLINK_STA_INFO_INACTIVE_TIME,1768 QLINK_STA_INFO_RX_BYTES,1769 QLINK_STA_INFO_TX_BYTES,1770 QLINK_STA_INFO_RX_BYTES64,1771 QLINK_STA_INFO_TX_BYTES64,1772 QLINK_STA_INFO_RX_DROP_MISC,1773 QLINK_STA_INFO_BEACON_RX,1774 QLINK_STA_INFO_SIGNAL,1775 QLINK_STA_INFO_SIGNAL_AVG,1776 QLINK_STA_INFO_RX_BITRATE,1777 QLINK_STA_INFO_TX_BITRATE,1778 QLINK_STA_INFO_RX_PACKETS,1779 QLINK_STA_INFO_TX_PACKETS,1780 QLINK_STA_INFO_TX_RETRIES,1781 QLINK_STA_INFO_TX_FAILED,1782 QLINK_STA_INFO_STA_FLAGS,1783 QLINK_STA_INFO_NUM,1784};1785 1786/**1787 * struct qlink_sta_info_rate - STA rate statistics1788 *1789 * @rate: data rate in Mbps.1790 * @flags: bitmap of &enum qlink_sta_info_rate_flags.1791 * @mcs: 802.11-defined MCS index.1792 * nss: Number of Spatial Streams.1793 * @bw: bandwidth, one of &enum qlink_channel_width.1794 */1795struct qlink_sta_info_rate {1796 __le16 rate;1797 u8 flags;1798 u8 mcs;1799 u8 nss;1800 u8 bw;1801} __packed;1802 1803/**1804 * struct qlink_sta_stats - data for QTN_TLV_ID_STA_STATS1805 *1806 * Carries statistics of a STA. Not all fields may be filled with1807 * valid values. Valid fields should be indicated as such using a bitmap of1808 * &enum qlink_sta_info. Bitmap is carried separately in a payload of1809 * QTN_TLV_ID_BITMAP.1810 */1811struct qlink_sta_stats {1812 __le64 rx_bytes;1813 __le64 tx_bytes;1814 __le64 rx_beacon;1815 __le64 rx_duration;1816 __le64 t_offset;1817 __le32 connected_time;1818 __le32 inactive_time;1819 __le32 rx_packets;1820 __le32 tx_packets;1821 __le32 tx_retries;1822 __le32 tx_failed;1823 __le32 rx_dropped_misc;1824 __le32 beacon_loss_count;1825 __le32 expected_throughput;1826 struct qlink_sta_info_state sta_flags;1827 struct qlink_sta_info_rate txrate;1828 struct qlink_sta_info_rate rxrate;1829 __le16 llid;1830 __le16 plid;1831 u8 local_pm;1832 u8 peer_pm;1833 u8 nonpeer_pm;1834 u8 rx_beacon_signal_avg;1835 u8 plink_state;1836 u8 signal;1837 u8 signal_avg;1838 u8 rsvd[1];1839};1840 1841/**1842 * struct qlink_random_mac_addr - data for QTN_TLV_ID_RANDOM_MAC_ADDR TLV1843 *1844 * Specifies MAC address mask/value for generation random MAC address1845 * during scan.1846 *1847 * @mac_addr: MAC address used with randomisation1848 * @mac_addr_mask: MAC address mask used with randomisation, bits that1849 * are 0 in the mask should be randomised, bits that are 1 should1850 * be taken from the @mac_addr1851 */1852struct qlink_random_mac_addr {1853 u8 mac_addr[ETH_ALEN];1854 u8 mac_addr_mask[ETH_ALEN];1855} __packed;1856 1857/**1858 * struct qlink_wowlan_capab_data - data for QTN_TLV_ID_WOWLAN_CAPAB TLV1859 *1860 * WoWLAN capabilities supported by cards.1861 *1862 * @version: version of WoWLAN data structure, to ensure backward1863 * compatibility for firmwares with limited WoWLAN support1864 * @len: Total length of WoWLAN data1865 * @data: supported WoWLAN features1866 */1867struct qlink_wowlan_capab_data {1868 __le16 version;1869 __le16 len;1870 u8 data[];1871} __packed;1872 1873/**1874 * struct qlink_wowlan_support - supported WoWLAN capabilities1875 *1876 * @n_patterns: number of supported wakeup patterns1877 * @pattern_max_len: maximum length of each pattern1878 * @pattern_min_len: minimum length of each pattern1879 */1880struct qlink_wowlan_support {1881 __le32 n_patterns;1882 __le32 pattern_max_len;1883 __le32 pattern_min_len;1884} __packed;1885 1886#endif /* _QTN_QLINK_H_ */1887