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		0xFFFF
10#define QLINK_PROTO_VER_MAJOR_S		16
11#define QLINK_PROTO_VER_MINOR_M		0xFFFF
12#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		18
18#define QLINK_PROTO_VER_MINOR		1
19#define QLINK_PROTO_VER		\
20	QLINK_VER(QLINK_PROTO_VER_MAJOR, QLINK_PROTO_VER_MINOR)
21
22#define QLINK_ALIGN	4
23
24#define QLINK_MACID_RSVD		0xFF
25#define QLINK_VIFID_RSVD		0xFF
26
27/* Common QLINK protocol messages definitions.
28 */
29
30/**
31 * enum qlink_msg_type - QLINK message types
32 *
33 * Used to distinguish between message types of QLINK protocol.
34 *
35 * @QLINK_MSG_TYPE_CMD: Message is carrying data of a command sent from
36 *	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 and
40 *	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	= 3
46};
47
48/**
49 * struct qlink_msg_header - common QLINK protocol message header
50 *
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 messages
62 */
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-out
69 *	associated STAs due to inactivity. Inactivity timeout period is taken
70 *	from QLINK_CMD_START_AP parameters.
71 * @QLINK_HW_CAPAB_DFS_OFFLOAD: device implements DFS offload functionality
72 * @QLINK_HW_CAPAB_SCAN_RANDOM_MAC_ADDR: device supports MAC Address
73 *	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_NUM
88};
89
90/**
91 * enum qlink_driver_capab - host driver capabilities.
92 *
93 */
94enum qlink_driver_capab {
95	QLINK_DRV_CAPAB_NUM = 0
96};
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_type
113 * @vlanid: VLAN ID for AP_VLAN interface type
114 * @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 definition
148 *
149 * @hw_value: hardware-specific value for the channel
150 * @center_freq: center frequency in MHz
151 * @flags: channel flags from &enum qlink_channel_flags
152 * @band: band this channel belongs to
153 * @max_antenna_gain: maximum antenna gain in dBi
154 * @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 beacon
159 *	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 definition
178 *
179 * @chan: primary channel definition
180 * @center_freq1: center frequency of first segment
181 * @center_freq2: center frequency of second segment (80+80 only)
182 * @width: channel width, one of @enum qlink_channel_width
183 */
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            5
193#define QLINK_MAX_NR_AKM_SUITES               2
194
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/value
212 *
213 * @mask: STA flags mask, bitmap of &enum qlink_sta_flags
214 * @value: STA flags values, bitmap of &enum qlink_sta_flags
215 */
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 set
223 *
224 * @QLINK_SR_PSR_DISALLOWED: indicates whether or not PSR-based spatial reuse
225 * transmissions are allowed for STAs associated with the AP
226 * @QLINK_SR_NON_SRG_OBSS_PD_SR_DISALLOWED: indicates whether or not
227 * Non-SRG OBSS PD spatial reuse transmissions are allowed for STAs associated
228 * with the AP
229 * @NON_SRG_OFFSET_PRESENT: indicates whether or not Non-SRG OBSS PD Max offset
230 * field is valid in the element
231 * @QLINK_SR_SRG_INFORMATION_PRESENT: indicates whether or not SRG OBSS PD
232 * Min/Max offset fields ore valid in the element
233 */
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 parameters
243 *
244 * @sr_control: spatial reuse control field; flags contained in this field are
245 * defined in @qlink_sr_ctrl_flags
246 * @non_srg_obss_pd_max: added to -82 dBm to generate the value of the
247 * Non-SRG OBSS PD Max parameter
248 * @srg_obss_pd_min_offset: added to -82 dBm to generate the value of the
249 * SRG OBSS PD Min parameter
250 * @srg_obss_pd_max_offset: added to -82 dBm to generate the value of the
251 * SRG PBSS PD Max parameter
252 */
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 definitions
261 */
262
263/**
264 * enum qlink_cmd_type - list of supported commands
265 *
266 * Commands are QLINK messages of type @QLINK_MSG_TYPE_CMD, sent by driver to
267 * wireless network device for processing. Device is expected to send back a
268 * reply message of type &QLINK_MSG_TYPE_CMDRSP, containing at least command
269 * execution status (one of &enum qlink_cmd_result). Reply message
270 * may also contain data payload specific to the command type.
271 *
272 * @QLINK_CMD_SEND_FRAME: send specified frame over the air; firmware will
273 *	encapsulate 802.3 packet into 802.11 frame automatically.
274 * @QLINK_CMD_BAND_INFO_GET: for the specified MAC and specified band, get
275 *	the band's description including number of operational channels and
276 *	info on each channel, HT/VHT capabilities, supported rates etc.
277 *	This command is generic to a specified MAC, interface index must be set
278 *	to QLINK_VIFID_RSVD in command header.
279 * @QLINK_CMD_REG_NOTIFY: notify device about regulatory domain change. This
280 *	command is supported only if device reports QLINK_HW_SUPPORTS_REG_UPDATE
281 *	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 for
284 *	the specified MAC.
285 * @QLINK_CMD_NDEV_EVENT: signalizes changes made with a corresponding network
286 *	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 header
330 *
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 with
336 *	response message.
337 * @macid: index of physical radio device the command is destined to or
338 *	QLINK_MACID_RSVD if not applicable.
339 * @vifid: index of virtual wireless interface on specified @macid the command
340 *	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_INIT
353 *
354 * Initialize firmware based on specified host configuration. This is the first
355 * command sent to wifi card and it's fixed part should never be changed, any
356 * additions must be done by appending TLVs.
357 * If wifi card can not operate with a specified parameters it will return
358 * 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 command
370 *
371 * Data for interface management commands QLINK_CMD_ADD_INTF, QLINK_CMD_DEL_INTF
372 * 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_COUNT
396};
397
398/**
399 * struct qlink_cmd_mgmt_frame_register - data for QLINK_CMD_REGISTER_MGMT
400 *
401 * @frame_type: MGMT frame type the registration request describes, one of
402 *	&enum qlink_mgmt_frame_type.
403 * @do_register: 0 - unregister, otherwise register for reception of specified
404 *	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, frame
415 *	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 command
426 *
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 command
442 *
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 type
459 * @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 command
474 *
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 command
488 *
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_KEY
503 *
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 command
514 *
515 * @flag_update: STA flags to update
516 * @if_type: Mode of interface operation, one of &enum qlink_iface_type
517 * @vlanid: VLAN ID to assign to specific STA
518 * @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_parameters
533 */
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 command
550 *
551 * @bssid: BSSID of the BSS to connect to.
552 * @bssid_hint: recommended AP BSSID for initial connection to the BSS or
553 *	00:00:00:00:00:00 if not specified.
554 * @prev_bssid: previous BSSID, if specified (not 00:00:00:00:00:00) indicates
555 *	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 overrides
561 * @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 command
586 *
587 * @bssid: BSSID of the BSS to connect to
588 * @status: authentication status code
589 * @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 command
600 *
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 command
611 *
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 bands
623 *
624 * @QLINK_BAND_2GHZ: 2.4GHz band
625 * @QLINK_BAND_5GHZ: 5GHz band
626 * @QLINK_BAND_60GHZ: 60GHz band
627 */
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 command
636 *
637 * @band: a PHY band for which information is queried, one of @enum qlink_band
638 */
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 command
647 *
648 * @channel_freq: channel center frequency
649 */
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 request
657 *
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 hint
669 *
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 command
680 *
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, one
684 *	of &enum qlink_user_reg_hint_type.
685 * @num_channels: number of &struct qlink_tlv_channel in a variable portion of a
686 *	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 flags
706 *
707 * @QLINK_CHAN_SW_RADAR_REQUIRED: whether radar detection is required on a new
708 *	channel.
709 * @QLINK_CHAN_SW_BLOCK_TX: whether transmissions should be blocked while
710 *	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 command
719 *
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 switch
723 */
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_SSID
736 *
737 * Refer to &enum nl80211_hidden_ssid
738 */
739enum qlink_hidden_ssid {
740	QLINK_HIDDEN_SSID_NOT_IN_USE,
741	QLINK_HIDDEN_SSID_ZERO_LEN,
742	QLINK_HIDDEN_SSID_ZERO_CONTENTS
743};
744
745/**
746 * struct qlink_cmd_start_ap - data for QLINK_CMD_START_AP command
747 *
748 * @beacon_interval: beacon interval
749 * @inactivity_timeout: station's inactivity period in seconds
750 * @dtim_period: DTIM period
751 * @hidden_ssid: whether to hide the SSID, one of &enum qlink_hidden_ssid
752 * @smps_mode: SMPS mode
753 * @ht_required: stations must support HT
754 * @vht_required: stations must support VHT
755 * @aen: encryption info
756 * @sr_params: spatial reuse parameters
757 * @twt_responder: enable Target Wake Time
758 * @info: variable configurations
759 */
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 command
781 *
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 data
802 *
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 mode
815 *
816 * @QLINK_PM_OFF: normal mode, no power saving enabled
817 * @QLINK_PM_AUTO_STANDBY: enable auto power save mode
818 */
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 command
826 *
827 * @pm_standby timer: period of network inactivity in seconds before
828 *	putting a radio in power save mode
829 * @pm_mode: power management mode
830 */
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 type
840 * @QLINK_TXPWR_SET: set tx power
841 * @QLINK_TXPWR_GET: get current tx power setting
842 */
843enum qlink_txpwr_op {
844	QLINK_TXPWR_SET,
845	QLINK_TXPWR_GET
846};
847
848/**
849 * struct qlink_cmd_txpwr - get or set current transmit power
850 *
851 * @txpwr: new transmit power setting, in mBm
852 * @txpwr_setting: transmit power setting type, one of
853 *	&enum nl80211_tx_power_setting
854 * @op_type: type of operation, one of &enum qlink_txpwr_op
855 */
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_trigger
866 *
867 * @QLINK_WOWLAN_TRIG_DISCONNECT: wakeup on disconnect
868 * @QLINK_WOWLAN_TRIG_MAGIC_PKT: wakeup on magic packet
869 * @QLINK_WOWLAN_TRIG_PATTERN_PKT: wakeup on user-defined packet
870 */
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 command
879 *
880 * @triggers: requested bitmask of WoWLAN triggers
881 */
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 command
894 *
895 * @event: type of event, one of &enum qlink_ndev_event_type
896 */
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_CHANGEUPPER
910 *
911 * @br_domain: layer 2 broadcast domain ID that ndev is a member of
912 * @upper_type: type of upper device, one of &enum qlink_ndev_upper_type
913 */
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 flags
926 *
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 command
938 *
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 the
941 *	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 scan
946 *	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 command
966 *
967 * @peer: MAC of the peer device for which OWE processing has been completed
968 * @status: OWE external processing status code
969 * @ies: IEs for the peer constructed by the user space
970 */
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 definitions
979 */
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 header
994 *
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 with
1000 *	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 or
1003 *	QLINK_MACID_RSVD if not applicable.
1004 * @vifid: index of virtual wireless interface on specified @macid the response
1005 *	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_INIT
1018 *
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 regions
1028 *
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 command
1040 *
1041 * Data describing specific physical device providing wireless MAC
1042 * functionality.
1043 *
1044 * @dev_mac: MAC address of physical WMAC device (used for first BSS on
1045 *	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 the
1056 *	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 command
1114 *
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 commands
1139 *
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 command
1160 *
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 cmd
1175 *
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 cmd
1192 *
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 command
1204 *
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 command
1214 *
1215 * This response is intended for QLINK_TXPWR_GET operation and does not
1216 * contain any meaningful information in case of QLINK_TXPWR_SET operation.
1217 *
1218 * @txpwr: current transmit power setting, in mBm
1219 */
1220struct qlink_resp_txpwr {
1221	struct qlink_resp rhdr;
1222	__le32 txpwr;
1223} __packed;
1224
1225/* QLINK Events messages related definitions
1226 */
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 header
1245 *
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 or
1251 *	QLINK_MACID_RSVD if not applicable.
1252 * @vifid: index of virtual wireless interface on specified @macid the event
1253 *	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 event
1264 *
1265 * @sta_addr: Address of a STA for which new association event was generated
1266 * @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 event
1278 *
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 event
1290 *
1291 * @chan: new operating channel definition
1292 * @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 event
1305 *
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 event
1316 *
1317 * @chan: new operating channel definition
1318 */
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 event
1330 *
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 event
1347 *
1348 * @tsf: TSF timestamp indicating when scan results were generated.
1349 * @freq: Center frequency of the channel where BSS for which the scan result
1350 *	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 event
1386 *
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 event
1406 *
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 event
1419 *
1420 * @ssid: SSID announced by BSS
1421 * @ssid_len: SSID length
1422 * @bssid: BSSID of the BSS to connect to
1423 * @akm_suite: AKM suite for external authentication
1424 * @action: action type/trigger for external authentication
1425 */
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 event
1437 *
1438 * @src: source MAC address of the frame
1439 * @key_index: index of the key being reported
1440 * @pairwise: whether the key is pairwise or group
1441 */
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 event
1451 *
1452 * @peer: MAC addr of the peer device for which OWE processing needs to be done
1453 * @ies: IEs from the peer
1454 */
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) definitions
1463 */
1464
1465/**
1466 * enum qlink_tlv_id - list of TLVs that Qlink messages can carry
1467 *
1468 * @QTN_TLV_ID_BITMAP: a data representing a bitmap that is used together with
1469 *	other TLVs:
1470 *	&enum qlink_sta_info used to indicate which statistic carried in
1471 *	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 in
1475 *	QTN_TLV_ID_CHANNEL_STATS is valid.
1476 * @QTN_TLV_ID_STA_STATS: per-STA statistics as defined by
1477 *	&struct qlink_sta_stats. Valid values are marked as such in a bitmap
1478 *	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	120
1531
1532/**
1533 * enum qlink_reg_rule_flags - regulatory rule flags
1534 *
1535 * See description of &enum nl80211_reg_rule_flags
1536 */
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 TLV
1556 *
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 be
1562 *	configured to.
1563 * @max_antenna_gain: max antenna gain that can be used in the specified
1564 *	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 TLV
1603 *
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 TLV
1615 *
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_SET
1640 *
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 IE
1655 *
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		25
1667struct 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_DATA
1676 *
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 bitmap
1689 *
1690 * Used to indicate which statistics values in &struct qlink_chan_stats
1691 * are valid. Individual values are used to fill a bitmap carried in a
1692 * 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_STATS
1715 *
1716 * Carries a per-channel statistics. Not all fields may be filled with
1717 * valid values. Valid fields should be indicated as such using a bitmap of
1718 * &enum qlink_chan_stat. Bitmap is carried separately in a payload of
1719 * 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 bitmap
1742 *
1743 * Used to indicate which statistics values in &struct qlink_sta_stats
1744 * are valid. Individual values are used to fill a bitmap carried in a
1745 * 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 statistics
1788 *
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_STATS
1805 *
1806 * Carries statistics of a STA. Not all fields may be filled with
1807 * valid values. Valid fields should be indicated as such using a bitmap of
1808 * &enum qlink_sta_info. Bitmap is carried separately in a payload of
1809 * 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 TLV
1843 *
1844 * Specifies MAC address mask/value for generation random MAC address
1845 * during scan.
1846 *
1847 * @mac_addr: MAC address used with randomisation
1848 * @mac_addr_mask: MAC address mask used with randomisation, bits that
1849 *	are 0 in the mask should be randomised, bits that are 1 should
1850 *	be taken from the @mac_addr
1851 */
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 TLV
1859 *
1860 * WoWLAN capabilities supported by cards.
1861 *
1862 * @version: version of WoWLAN data structure, to ensure backward
1863 *	compatibility for firmwares with limited WoWLAN support
1864 * @len: Total length of WoWLAN data
1865 * @data: supported WoWLAN features
1866 */
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 capabilities
1875 *
1876 * @n_patterns: number of supported wakeup patterns
1877 * @pattern_max_len: maximum length of each pattern
1878 * @pattern_min_len: minimum length of each pattern
1879 */
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