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 15
10
11 #define QLINK_MACID_RSVD 0xFF
12 #define QLINK_VIFID_RSVD 0xFF
13
14 /* Common QLINK protocol messages definitions.
15 */
16
17 /**
18 * enum qlink_msg_type - QLINK message types
19 *
20 * Used to distinguish between message types of QLINK protocol.
21 *
22 * @QLINK_MSG_TYPE_CMD: Message is carrying data of a command sent from
23 * driver to wireless hardware.
24 * @QLINK_MSG_TYPE_CMDRSP: Message is carrying data of a response to a command.
25 * Sent from wireless HW to driver in reply to previously issued command.
26 * @QLINK_MSG_TYPE_EVENT: Data for an event originated in wireless hardware and
27 * sent asynchronously to driver.
28 */
29 enum qlink_msg_type {
30 QLINK_MSG_TYPE_CMD = 1,
31 QLINK_MSG_TYPE_CMDRSP = 2,
32 QLINK_MSG_TYPE_EVENT = 3
33 };
34
35 /**
36 * struct qlink_msg_header - common QLINK protocol message header
37 *
38 * Portion of QLINK protocol header common for all message types.
39 *
40 * @type: Message type, one of &enum qlink_msg_type.
41 * @len: Total length of message including all headers.
42 */
43 struct qlink_msg_header {
44 __le16 type;
45 __le16 len;
46 } __packed;
47
48 /* Generic definitions of data and information carried in QLINK messages
49 */
50
51 /**
52 * enum qlink_hw_capab - device capabilities.
53 *
54 * @QLINK_HW_CAPAB_REG_UPDATE: device can update it's regulatory region.
55 * @QLINK_HW_CAPAB_STA_INACT_TIMEOUT: device implements a logic to kick-out
56 * associated STAs due to inactivity. Inactivity timeout period is taken
57 * from QLINK_CMD_START_AP parameters.
58 * @QLINK_HW_CAPAB_DFS_OFFLOAD: device implements DFS offload functionality
59 * @QLINK_HW_CAPAB_SCAN_RANDOM_MAC_ADDR: device supports MAC Address
60 * Randomization in probe requests.
61 * @QLINK_HW_CAPAB_OBSS_SCAN: device can perform OBSS scanning.
62 */
63 enum qlink_hw_capab {
64 QLINK_HW_CAPAB_REG_UPDATE = BIT(0),
65 QLINK_HW_CAPAB_STA_INACT_TIMEOUT = BIT(1),
66 QLINK_HW_CAPAB_DFS_OFFLOAD = BIT(2),
67 QLINK_HW_CAPAB_SCAN_RANDOM_MAC_ADDR = BIT(3),
68 QLINK_HW_CAPAB_PWR_MGMT = BIT(4),
69 QLINK_HW_CAPAB_OBSS_SCAN = BIT(5),
70 QLINK_HW_CAPAB_SCAN_DWELL = BIT(6),
71 QLINK_HW_CAPAB_SAE = BIT(8),
72 };
73
74 enum qlink_iface_type {
75 QLINK_IFTYPE_AP = 1,
76 QLINK_IFTYPE_STATION = 2,
77 QLINK_IFTYPE_ADHOC = 3,
78 QLINK_IFTYPE_MONITOR = 4,
79 QLINK_IFTYPE_WDS = 5,
80 QLINK_IFTYPE_AP_VLAN = 6,
81 };
82
83 /**
84 * struct qlink_intf_info - information on virtual interface.
85 *
86 * Data describing a single virtual interface.
87 *
88 * @if_type: Mode of interface operation, one of &enum qlink_iface_type
89 * @vlanid: VLAN ID for AP_VLAN interface type
90 * @mac_addr: MAC address of virtual interface.
91 */
92 struct qlink_intf_info {
93 __le16 if_type;
94 __le16 vlanid;
95 u8 mac_addr[ETH_ALEN];
96 u8 use4addr;
97 u8 rsvd[1];
98 } __packed;
99
100 enum qlink_sta_flags {
101 QLINK_STA_FLAG_INVALID = 0,
102 QLINK_STA_FLAG_AUTHORIZED = BIT(0),
103 QLINK_STA_FLAG_SHORT_PREAMBLE = BIT(1),
104 QLINK_STA_FLAG_WME = BIT(2),
105 QLINK_STA_FLAG_MFP = BIT(3),
106 QLINK_STA_FLAG_AUTHENTICATED = BIT(4),
107 QLINK_STA_FLAG_TDLS_PEER = BIT(5),
108 QLINK_STA_FLAG_ASSOCIATED = BIT(6),
109 };
110
111 enum qlink_channel_width {
112 QLINK_CHAN_WIDTH_5 = 0,
113 QLINK_CHAN_WIDTH_10,
114 QLINK_CHAN_WIDTH_20_NOHT,
115 QLINK_CHAN_WIDTH_20,
116 QLINK_CHAN_WIDTH_40,
117 QLINK_CHAN_WIDTH_80,
118 QLINK_CHAN_WIDTH_80P80,
119 QLINK_CHAN_WIDTH_160,
120 };
121
122 /**
123 * struct qlink_channel - qlink control channel definition
124 *
125 * @hw_value: hardware-specific value for the channel
126 * @center_freq: center frequency in MHz
127 * @flags: channel flags from &enum qlink_channel_flags
128 * @band: band this channel belongs to
129 * @max_antenna_gain: maximum antenna gain in dBi
130 * @max_power: maximum transmission power (in dBm)
131 * @max_reg_power: maximum regulatory transmission power (in dBm)
132 * @dfs_state: current state of this channel.
133 * Only relevant if radar is required on this channel.
134 * @beacon_found: helper to regulatory code to indicate when a beacon
135 * has been found on this channel. Use regulatory_hint_found_beacon()
136 * to enable this, this is useful only on 5 GHz band.
137 */
138 struct qlink_channel {
139 __le16 hw_value;
140 __le16 center_freq;
141 __le32 flags;
142 u8 band;
143 u8 max_antenna_gain;
144 u8 max_power;
145 u8 max_reg_power;
146 __le32 dfs_cac_ms;
147 u8 dfs_state;
148 u8 beacon_found;
149 u8 rsvd[2];
150 } __packed;
151
152 /**
153 * struct qlink_chandef - qlink channel definition
154 *
155 * @chan: primary channel definition
156 * @center_freq1: center frequency of first segment
157 * @center_freq2: center frequency of second segment (80+80 only)
158 * @width: channel width, one of @enum qlink_channel_width
159 */
160 struct qlink_chandef {
161 struct qlink_channel chan;
162 __le16 center_freq1;
163 __le16 center_freq2;
164 u8 width;
165 u8 rsvd;
166 } __packed;
167
168 #define QLINK_MAX_NR_CIPHER_SUITES 5
169 #define QLINK_MAX_NR_AKM_SUITES 2
170
171 struct qlink_auth_encr {
172 __le32 wpa_versions;
173 __le32 cipher_group;
174 __le32 n_ciphers_pairwise;
175 __le32 ciphers_pairwise[QLINK_MAX_NR_CIPHER_SUITES];
176 __le32 n_akm_suites;
177 __le32 akm_suites[QLINK_MAX_NR_AKM_SUITES];
178 __le16 control_port_ethertype;
179 u8 auth_type;
180 u8 privacy;
181 u8 control_port;
182 u8 control_port_no_encrypt;
183 u8 rsvd[2];
184 } __packed;
185
186 /**
187 * struct qlink_sta_info_state - station flags mask/value
188 *
189 * @mask: STA flags mask, bitmap of &enum qlink_sta_flags
190 * @value: STA flags values, bitmap of &enum qlink_sta_flags
191 */
192 struct qlink_sta_info_state {
193 __le32 mask;
194 __le32 value;
195 } __packed;
196
197 /* QLINK Command messages related definitions
198 */
199
200 /**
201 * enum qlink_cmd_type - list of supported commands
202 *
203 * Commands are QLINK messages of type @QLINK_MSG_TYPE_CMD, sent by driver to
204 * wireless network device for processing. Device is expected to send back a
205 * reply message of type &QLINK_MSG_TYPE_CMDRSP, containing at least command
206 * execution status (one of &enum qlink_cmd_result). Reply message
207 * may also contain data payload specific to the command type.
208 *
209 * @QLINK_CMD_SEND_FRAME: send specified frame over the air; firmware will
210 * encapsulate 802.3 packet into 802.11 frame automatically.
211 * @QLINK_CMD_BAND_INFO_GET: for the specified MAC and specified band, get
212 * the band's description including number of operational channels and
213 * info on each channel, HT/VHT capabilities, supported rates etc.
214 * This command is generic to a specified MAC, interface index must be set
215 * to QLINK_VIFID_RSVD in command header.
216 * @QLINK_CMD_REG_NOTIFY: notify device about regulatory domain change. This
217 * command is supported only if device reports QLINK_HW_SUPPORTS_REG_UPDATE
218 * capability.
219 * @QLINK_CMD_START_CAC: start radar detection procedure on a specified channel.
220 */
221 enum qlink_cmd_type {
222 QLINK_CMD_FW_INIT = 0x0001,
223 QLINK_CMD_FW_DEINIT = 0x0002,
224 QLINK_CMD_REGISTER_MGMT = 0x0003,
225 QLINK_CMD_SEND_FRAME = 0x0004,
226 QLINK_CMD_MGMT_SET_APPIE = 0x0005,
227 QLINK_CMD_PHY_PARAMS_GET = 0x0011,
228 QLINK_CMD_PHY_PARAMS_SET = 0x0012,
229 QLINK_CMD_GET_HW_INFO = 0x0013,
230 QLINK_CMD_MAC_INFO = 0x0014,
231 QLINK_CMD_ADD_INTF = 0x0015,
232 QLINK_CMD_DEL_INTF = 0x0016,
233 QLINK_CMD_CHANGE_INTF = 0x0017,
234 QLINK_CMD_UPDOWN_INTF = 0x0018,
235 QLINK_CMD_REG_NOTIFY = 0x0019,
236 QLINK_CMD_BAND_INFO_GET = 0x001A,
237 QLINK_CMD_CHAN_SWITCH = 0x001B,
238 QLINK_CMD_CHAN_GET = 0x001C,
239 QLINK_CMD_START_CAC = 0x001D,
240 QLINK_CMD_START_AP = 0x0021,
241 QLINK_CMD_STOP_AP = 0x0022,
242 QLINK_CMD_SET_MAC_ACL = 0x0023,
243 QLINK_CMD_GET_STA_INFO = 0x0030,
244 QLINK_CMD_ADD_KEY = 0x0040,
245 QLINK_CMD_DEL_KEY = 0x0041,
246 QLINK_CMD_SET_DEFAULT_KEY = 0x0042,
247 QLINK_CMD_SET_DEFAULT_MGMT_KEY = 0x0043,
248 QLINK_CMD_CHANGE_STA = 0x0051,
249 QLINK_CMD_DEL_STA = 0x0052,
250 QLINK_CMD_SCAN = 0x0053,
251 QLINK_CMD_CHAN_STATS = 0x0054,
252 QLINK_CMD_CONNECT = 0x0060,
253 QLINK_CMD_DISCONNECT = 0x0061,
254 QLINK_CMD_PM_SET = 0x0062,
255 QLINK_CMD_WOWLAN_SET = 0x0063,
256 QLINK_CMD_EXTERNAL_AUTH = 0x0066,
257 };
258
259 /**
260 * struct qlink_cmd - QLINK command message header
261 *
262 * Header used for QLINK messages of QLINK_MSG_TYPE_CMD type.
263 *
264 * @mhdr: Common QLINK message header.
265 * @cmd_id: command id, one of &enum qlink_cmd_type.
266 * @seq_num: sequence number of command message, used for matching with
267 * response message.
268 * @macid: index of physical radio device the command is destined to or
269 * QLINK_MACID_RSVD if not applicable.
270 * @vifid: index of virtual wireless interface on specified @macid the command
271 * is destined to or QLINK_VIFID_RSVD if not applicable.
272 */
273 struct qlink_cmd {
274 struct qlink_msg_header mhdr;
275 __le16 cmd_id;
276 __le16 seq_num;
277 u8 rsvd[2];
278 u8 macid;
279 u8 vifid;
280 } __packed;
281
282 /**
283 * struct qlink_cmd_manage_intf - interface management command
284 *
285 * Data for interface management commands QLINK_CMD_ADD_INTF, QLINK_CMD_DEL_INTF
286 * and QLINK_CMD_CHANGE_INTF.
287 *
288 * @intf_info: interface description.
289 */
290 struct qlink_cmd_manage_intf {
291 struct qlink_cmd chdr;
292 struct qlink_intf_info intf_info;
293 } __packed;
294
295 enum qlink_mgmt_frame_type {
296 QLINK_MGMT_FRAME_ASSOC_REQ = 0x00,
297 QLINK_MGMT_FRAME_ASSOC_RESP = 0x01,
298 QLINK_MGMT_FRAME_REASSOC_REQ = 0x02,
299 QLINK_MGMT_FRAME_REASSOC_RESP = 0x03,
300 QLINK_MGMT_FRAME_PROBE_REQ = 0x04,
301 QLINK_MGMT_FRAME_PROBE_RESP = 0x05,
302 QLINK_MGMT_FRAME_BEACON = 0x06,
303 QLINK_MGMT_FRAME_ATIM = 0x07,
304 QLINK_MGMT_FRAME_DISASSOC = 0x08,
305 QLINK_MGMT_FRAME_AUTH = 0x09,
306 QLINK_MGMT_FRAME_DEAUTH = 0x0A,
307 QLINK_MGMT_FRAME_ACTION = 0x0B,
308
309 QLINK_MGMT_FRAME_TYPE_COUNT
310 };
311
312 /**
313 * struct qlink_cmd_mgmt_frame_register - data for QLINK_CMD_REGISTER_MGMT
314 *
315 * @frame_type: MGMT frame type the registration request describes, one of
316 * &enum qlink_mgmt_frame_type.
317 * @do_register: 0 - unregister, otherwise register for reception of specified
318 * MGMT frame type.
319 */
320 struct qlink_cmd_mgmt_frame_register {
321 struct qlink_cmd chdr;
322 __le16 frame_type;
323 u8 do_register;
324 } __packed;
325
326 /**
327 * @QLINK_FRAME_TX_FLAG_8023: frame has a 802.3 header; if not set, frame
328 * is a 802.11 encapsulated.
329 */
330 enum qlink_frame_tx_flags {
331 QLINK_FRAME_TX_FLAG_OFFCHAN = BIT(0),
332 QLINK_FRAME_TX_FLAG_NO_CCK = BIT(1),
333 QLINK_FRAME_TX_FLAG_ACK_NOWAIT = BIT(2),
334 QLINK_FRAME_TX_FLAG_8023 = BIT(3),
335 };
336
337 /**
338 * struct qlink_cmd_frame_tx - data for QLINK_CMD_SEND_FRAME command
339 *
340 * @cookie: opaque request identifier.
341 * @freq: Frequency to use for frame transmission.
342 * @flags: Transmission flags, one of &enum qlink_frame_tx_flags.
343 * @frame_data: frame to transmit.
344 */
345 struct qlink_cmd_frame_tx {
346 struct qlink_cmd chdr;
347 __le32 cookie;
348 __le16 freq;
349 __le16 flags;
350 u8 frame_data[0];
351 } __packed;
352
353 /**
354 * struct qlink_cmd_get_sta_info - data for QLINK_CMD_GET_STA_INFO command
355 *
356 * @sta_addr: MAC address of the STA statistics is requested for.
357 */
358 struct qlink_cmd_get_sta_info {
359 struct qlink_cmd chdr;
360 u8 sta_addr[ETH_ALEN];
361 } __packed;
362
363 /**
364 * struct qlink_cmd_add_key - data for QLINK_CMD_ADD_KEY command.
365 *
366 * @key_index: index of the key being installed.
367 * @pairwise: whether to use pairwise key.
368 * @addr: MAC address of a STA key is being installed to.
369 * @cipher: cipher suite.
370 * @vlanid: VLAN ID for AP_VLAN interface type
371 * @key_data: key data itself.
372 */
373 struct qlink_cmd_add_key {
374 struct qlink_cmd chdr;
375 u8 key_index;
376 u8 pairwise;
377 u8 addr[ETH_ALEN];
378 __le32 cipher;
379 __le16 vlanid;
380 u8 key_data[0];
381 } __packed;
382
383 /**
384 * struct qlink_cmd_del_key_req - data for QLINK_CMD_DEL_KEY command
385 *
386 * @key_index: index of the key being removed.
387 * @pairwise: whether to use pairwise key.
388 * @addr: MAC address of a STA for which a key is removed.
389 */
390 struct qlink_cmd_del_key {
391 struct qlink_cmd chdr;
392 u8 key_index;
393 u8 pairwise;
394 u8 addr[ETH_ALEN];
395 } __packed;
396
397 /**
398 * struct qlink_cmd_set_def_key - data for QLINK_CMD_SET_DEFAULT_KEY command
399 *
400 * @key_index: index of the key to be set as default one.
401 * @unicast: key is unicast.
402 * @multicast: key is multicast.
403 */
404 struct qlink_cmd_set_def_key {
405 struct qlink_cmd chdr;
406 u8 key_index;
407 u8 unicast;
408 u8 multicast;
409 } __packed;
410
411 /**
412 * struct qlink_cmd_set_def_mgmt_key - data for QLINK_CMD_SET_DEFAULT_MGMT_KEY
413 *
414 * @key_index: index of the key to be set as default MGMT key.
415 */
416 struct qlink_cmd_set_def_mgmt_key {
417 struct qlink_cmd chdr;
418 u8 key_index;
419 } __packed;
420
421 /**
422 * struct qlink_cmd_change_sta - data for QLINK_CMD_CHANGE_STA command
423 *
424 * @flag_update: STA flags to update
425 * @if_type: Mode of interface operation, one of &enum qlink_iface_type
426 * @vlanid: VLAN ID to assign to specific STA
427 * @sta_addr: address of the STA for which parameters are set.
428 */
429 struct qlink_cmd_change_sta {
430 struct qlink_cmd chdr;
431 struct qlink_sta_info_state flag_update;
432 __le16 if_type;
433 __le16 vlanid;
434 u8 sta_addr[ETH_ALEN];
435 } __packed;
436
437 /**
438 * struct qlink_cmd_del_sta - data for QLINK_CMD_DEL_STA command.
439 *
440 * See &struct station_del_parameters
441 */
442 struct qlink_cmd_del_sta {
443 struct qlink_cmd chdr;
444 __le16 reason_code;
445 u8 subtype;
446 u8 sta_addr[ETH_ALEN];
447 } __packed;
448
449 enum qlink_sta_connect_flags {
450 QLINK_STA_CONNECT_DISABLE_HT = BIT(0),
451 QLINK_STA_CONNECT_DISABLE_VHT = BIT(1),
452 QLINK_STA_CONNECT_USE_RRM = BIT(2),
453 };
454
455 /**
456 * struct qlink_cmd_connect - data for QLINK_CMD_CONNECT command
457 *
458 * @bssid: BSSID of the BSS to connect to.
459 * @bssid_hint: recommended AP BSSID for initial connection to the BSS or
460 * 00:00:00:00:00:00 if not specified.
461 * @prev_bssid: previous BSSID, if specified (not 00:00:00:00:00:00) indicates
462 * a request to reassociate.
463 * @bg_scan_period: period of background scan.
464 * @flags: one of &enum qlink_sta_connect_flags.
465 * @ht_capa: HT Capabilities overrides.
466 * @ht_capa_mask: The bits of ht_capa which are to be used.
467 * @vht_capa: VHT Capability overrides
468 * @vht_capa_mask: The bits of vht_capa which are to be used.
469 * @aen: authentication information.
470 * @mfp: whether to use management frame protection.
471 * @payload: variable portion of connection request.
472 */
473 struct qlink_cmd_connect {
474 struct qlink_cmd chdr;
475 u8 bssid[ETH_ALEN];
476 u8 bssid_hint[ETH_ALEN];
477 u8 prev_bssid[ETH_ALEN];
478 __le16 bg_scan_period;
479 __le32 flags;
480 struct ieee80211_ht_cap ht_capa;
481 struct ieee80211_ht_cap ht_capa_mask;
482 struct ieee80211_vht_cap vht_capa;
483 struct ieee80211_vht_cap vht_capa_mask;
484 struct qlink_auth_encr aen;
485 u8 mfp;
486 u8 pbss;
487 u8 rsvd[2];
488 u8 payload[0];
489 } __packed;
490
491 /**
492 * struct qlink_cmd_external_auth - data for QLINK_CMD_EXTERNAL_AUTH command
493 *
494 * @bssid: BSSID of the BSS to connect to
495 * @status: authentication status code
496 * @payload: variable portion of connection request.
497 */
498 struct qlink_cmd_external_auth {
499 struct qlink_cmd chdr;
500 u8 bssid[ETH_ALEN];
501 __le16 status;
502 u8 payload[0];
503 } __packed;
504
505 /**
506 * struct qlink_cmd_disconnect - data for QLINK_CMD_DISCONNECT command
507 *
508 * @reason: code of the reason of disconnect, see &enum ieee80211_reasoncode.
509 */
510 struct qlink_cmd_disconnect {
511 struct qlink_cmd chdr;
512 __le16 reason;
513 } __packed;
514
515 /**
516 * struct qlink_cmd_updown - data for QLINK_CMD_UPDOWN_INTF command
517 *
518 * @if_up: bring specified interface DOWN (if_up==0) or UP (otherwise).
519 * Interface is specified in common command header @chdr.
520 */
521 struct qlink_cmd_updown {
522 struct qlink_cmd chdr;
523 u8 if_up;
524 } __packed;
525
526 /**
527 * enum qlink_band - a list of frequency bands
528 *
529 * @QLINK_BAND_2GHZ: 2.4GHz band
530 * @QLINK_BAND_5GHZ: 5GHz band
531 * @QLINK_BAND_60GHZ: 60GHz band
532 */
533 enum qlink_band {
534 QLINK_BAND_2GHZ = BIT(0),
535 QLINK_BAND_5GHZ = BIT(1),
536 QLINK_BAND_60GHZ = BIT(2),
537 };
538
539 /**
540 * struct qlink_cmd_band_info_get - data for QLINK_CMD_BAND_INFO_GET command
541 *
542 * @band: a PHY band for which information is queried, one of @enum qlink_band
543 */
544 struct qlink_cmd_band_info_get {
545 struct qlink_cmd chdr;
546 u8 band;
547 } __packed;
548
549 /**
550 * struct qlink_cmd_get_chan_stats - data for QLINK_CMD_CHAN_STATS command
551 *
552 * @channel: channel number according to 802.11 17.3.8.3.2 and Annex J
553 */
554 struct qlink_cmd_get_chan_stats {
555 struct qlink_cmd chdr;
556 __le16 channel;
557 } __packed;
558
559 /**
560 * enum qlink_reg_initiator - Indicates the initiator of a reg domain request
561 *
562 * See &enum nl80211_reg_initiator for more info.
563 */
564 enum qlink_reg_initiator {
565 QLINK_REGDOM_SET_BY_CORE,
566 QLINK_REGDOM_SET_BY_USER,
567 QLINK_REGDOM_SET_BY_DRIVER,
568 QLINK_REGDOM_SET_BY_COUNTRY_IE,
569 };
570
571 /**
572 * enum qlink_user_reg_hint_type - type of user regulatory hint
573 *
574 * See &enum nl80211_user_reg_hint_type for more info.
575 */
576 enum qlink_user_reg_hint_type {
577 QLINK_USER_REG_HINT_USER = 0,
578 QLINK_USER_REG_HINT_CELL_BASE = 1,
579 QLINK_USER_REG_HINT_INDOOR = 2,
580 };
581
582 /**
583 * struct qlink_cmd_reg_notify - data for QLINK_CMD_REG_NOTIFY command
584 *
585 * @alpha2: the ISO / IEC 3166 alpha2 country code.
586 * @initiator: which entity sent the request, one of &enum qlink_reg_initiator.
587 * @user_reg_hint_type: type of hint for QLINK_REGDOM_SET_BY_USER request, one
588 * of &enum qlink_user_reg_hint_type.
589 * @num_channels: number of &struct qlink_tlv_channel in a variable portion of a
590 * payload.
591 * @slave_radar: whether slave device should enable radar detection.
592 * @dfs_region: one of &enum qlink_dfs_regions.
593 * @info: variable portion of regulatory notifier callback.
594 */
595 struct qlink_cmd_reg_notify {
596 struct qlink_cmd chdr;
597 u8 alpha2[2];
598 u8 initiator;
599 u8 user_reg_hint_type;
600 u8 num_channels;
601 u8 dfs_region;
602 u8 slave_radar;
603 u8 rsvd[1];
604 u8 info[0];
605 } __packed;
606
607 /**
608 * struct qlink_cmd_chan_switch - data for QLINK_CMD_CHAN_SWITCH command
609 *
610 * @channel: channel number according to 802.11 17.3.8.3.2 and Annex J
611 * @radar_required: whether radar detection is required on the new channel
612 * @block_tx: whether transmissions should be blocked while changing
613 * @beacon_count: number of beacons until switch
614 */
615 struct qlink_cmd_chan_switch {
616 struct qlink_cmd chdr;
617 __le16 channel;
618 u8 radar_required;
619 u8 block_tx;
620 u8 beacon_count;
621 } __packed;
622
623 /**
624 * enum qlink_hidden_ssid - values for %NL80211_ATTR_HIDDEN_SSID
625 *
626 * Refer to &enum nl80211_hidden_ssid
627 */
628 enum qlink_hidden_ssid {
629 QLINK_HIDDEN_SSID_NOT_IN_USE,
630 QLINK_HIDDEN_SSID_ZERO_LEN,
631 QLINK_HIDDEN_SSID_ZERO_CONTENTS
632 };
633
634 /**
635 * struct qlink_cmd_start_ap - data for QLINK_CMD_START_AP command
636 *
637 * @beacon_interval: beacon interval
638 * @inactivity_timeout: station's inactivity period in seconds
639 * @dtim_period: DTIM period
640 * @hidden_ssid: whether to hide the SSID, one of &enum qlink_hidden_ssid
641 * @smps_mode: SMPS mode
642 * @ht_required: stations must support HT
643 * @vht_required: stations must support VHT
644 * @aen: encryption info
645 * @info: variable configurations
646 */
647 struct qlink_cmd_start_ap {
648 struct qlink_cmd chdr;
649 __le16 beacon_interval;
650 __le16 inactivity_timeout;
651 u8 dtim_period;
652 u8 hidden_ssid;
653 u8 smps_mode;
654 u8 p2p_ctwindow;
655 u8 p2p_opp_ps;
656 u8 pbss;
657 u8 ht_required;
658 u8 vht_required;
659 struct qlink_auth_encr aen;
660 u8 info[0];
661 } __packed;
662
663 /**
664 * struct qlink_cmd_start_cac - data for QLINK_CMD_START_CAC command
665 *
666 * @chan: a channel to start a radar detection procedure on.
667 * @cac_time_ms: CAC time.
668 */
669 struct qlink_cmd_start_cac {
670 struct qlink_cmd chdr;
671 struct qlink_chandef chan;
672 __le32 cac_time_ms;
673 } __packed;
674
675 enum qlink_acl_policy {
676 QLINK_ACL_POLICY_ACCEPT_UNLESS_LISTED,
677 QLINK_ACL_POLICY_DENY_UNLESS_LISTED,
678 };
679
680 struct qlink_mac_address {
681 u8 addr[ETH_ALEN];
682 } __packed;
683
684 /**
685 * struct qlink_acl_data - ACL data
686 *
687 * @policy: filter policy, one of &enum qlink_acl_policy.
688 * @num_entries: number of MAC addresses in array.
689 * @mac_address: MAC addresses array.
690 */
691 struct qlink_acl_data {
692 __le32 policy;
693 __le32 num_entries;
694 struct qlink_mac_address mac_addrs[0];
695 } __packed;
696
697 /**
698 * enum qlink_pm_mode - Power Management mode
699 *
700 * @QLINK_PM_OFF: normal mode, no power saving enabled
701 * @QLINK_PM_AUTO_STANDBY: enable auto power save mode
702 */
703 enum qlink_pm_mode {
704 QLINK_PM_OFF = 0,
705 QLINK_PM_AUTO_STANDBY = 1,
706 };
707
708 /**
709 * struct qlink_cmd_pm_set - data for QLINK_CMD_PM_SET command
710 *
711 * @pm_standby timer: period of network inactivity in seconds before
712 * putting a radio in power save mode
713 * @pm_mode: power management mode
714 */
715 struct qlink_cmd_pm_set {
716 struct qlink_cmd chdr;
717 __le32 pm_standby_timer;
718 u8 pm_mode;
719 } __packed;
720
721 /**
722 * enum qlink_wowlan_trigger
723 *
724 * @QLINK_WOWLAN_TRIG_DISCONNECT: wakeup on disconnect
725 * @QLINK_WOWLAN_TRIG_MAGIC_PKT: wakeup on magic packet
726 * @QLINK_WOWLAN_TRIG_PATTERN_PKT: wakeup on user-defined packet
727 */
728 enum qlink_wowlan_trigger {
729 QLINK_WOWLAN_TRIG_DISCONNECT = BIT(0),
730 QLINK_WOWLAN_TRIG_MAGIC_PKT = BIT(1),
731 QLINK_WOWLAN_TRIG_PATTERN_PKT = BIT(2),
732 };
733
734 /**
735 * struct qlink_cmd_wowlan_set - data for QLINK_CMD_WOWLAN_SET command
736 *
737 * @triggers: requested bitmask of WoWLAN triggers
738 */
739 struct qlink_cmd_wowlan_set {
740 struct qlink_cmd chdr;
741 __le32 triggers;
742 u8 data[0];
743 } __packed;
744
745 /* QLINK Command Responses messages related definitions
746 */
747
748 enum qlink_cmd_result {
749 QLINK_CMD_RESULT_OK = 0,
750 QLINK_CMD_RESULT_INVALID,
751 QLINK_CMD_RESULT_ENOTSUPP,
752 QLINK_CMD_RESULT_ENOTFOUND,
753 QLINK_CMD_RESULT_EALREADY,
754 QLINK_CMD_RESULT_EADDRINUSE,
755 QLINK_CMD_RESULT_EADDRNOTAVAIL,
756 QLINK_CMD_RESULT_EBUSY,
757 };
758
759 /**
760 * struct qlink_resp - QLINK command response message header
761 *
762 * Header used for QLINK messages of QLINK_MSG_TYPE_CMDRSP type.
763 *
764 * @mhdr: see &struct qlink_msg_header.
765 * @cmd_id: command ID the response corresponds to, one of &enum qlink_cmd_type.
766 * @seq_num: sequence number of command message, used for matching with
767 * response message.
768 * @result: result of the command execution, one of &enum qlink_cmd_result.
769 * @macid: index of physical radio device the response is sent from or
770 * QLINK_MACID_RSVD if not applicable.
771 * @vifid: index of virtual wireless interface on specified @macid the response
772 * is sent from or QLINK_VIFID_RSVD if not applicable.
773 */
774 struct qlink_resp {
775 struct qlink_msg_header mhdr;
776 __le16 cmd_id;
777 __le16 seq_num;
778 __le16 result;
779 u8 macid;
780 u8 vifid;
781 } __packed;
782
783 /**
784 * enum qlink_dfs_regions - regulatory DFS regions
785 *
786 * Corresponds to &enum nl80211_dfs_regions.
787 */
788 enum qlink_dfs_regions {
789 QLINK_DFS_UNSET = 0,
790 QLINK_DFS_FCC = 1,
791 QLINK_DFS_ETSI = 2,
792 QLINK_DFS_JP = 3,
793 };
794
795 /**
796 * struct qlink_resp_get_mac_info - response for QLINK_CMD_MAC_INFO command
797 *
798 * Data describing specific physical device providing wireless MAC
799 * functionality.
800 *
801 * @dev_mac: MAC address of physical WMAC device (used for first BSS on
802 * specified WMAC).
803 * @num_tx_chain: Number of transmit chains used by WMAC.
804 * @num_rx_chain: Number of receive chains used by WMAC.
805 * @vht_cap_mod_mask: mask specifying which VHT capabilities can be altered.
806 * @ht_cap_mod_mask: mask specifying which HT capabilities can be altered.
807 * @bands_cap: wireless bands WMAC can operate in, bitmap of &enum qlink_band.
808 * @max_ap_assoc_sta: Maximum number of associations supported by WMAC.
809 * @radar_detect_widths: bitmask of channels BW for which WMAC can detect radar.
810 * @alpha2: country code ID firmware is configured to.
811 * @n_reg_rules: number of regulatory rules TLVs in variable portion of the
812 * message.
813 * @dfs_region: regulatory DFS region, one of &enum qlink_dfs_regions.
814 * @var_info: variable-length WMAC info data.
815 */
816 struct qlink_resp_get_mac_info {
817 struct qlink_resp rhdr;
818 u8 dev_mac[ETH_ALEN];
819 u8 num_tx_chain;
820 u8 num_rx_chain;
821 struct ieee80211_vht_cap vht_cap_mod_mask;
822 struct ieee80211_ht_cap ht_cap_mod_mask;
823 __le16 max_ap_assoc_sta;
824 __le16 radar_detect_widths;
825 __le32 max_acl_mac_addrs;
826 u8 bands_cap;
827 u8 alpha2[2];
828 u8 n_reg_rules;
829 u8 dfs_region;
830 u8 rsvd[1];
831 u8 var_info[0];
832 } __packed;
833
834 /**
835 * struct qlink_resp_get_hw_info - response for QLINK_CMD_GET_HW_INFO command
836 *
837 * Description of wireless hardware capabilities and features.
838 *
839 * @fw_ver: wireless hardware firmware version.
840 * @hw_capab: Bitmap of capabilities supported by firmware.
841 * @ql_proto_ver: Version of QLINK protocol used by firmware.
842 * @num_mac: Number of separate physical radio devices provided by hardware.
843 * @mac_bitmap: Bitmap of MAC IDs that are active and can be used in firmware.
844 * @total_tx_chains: total number of transmit chains used by device.
845 * @total_rx_chains: total number of receive chains.
846 * @info: variable-length HW info.
847 */
848 struct qlink_resp_get_hw_info {
849 struct qlink_resp rhdr;
850 __le32 fw_ver;
851 __le32 hw_capab;
852 __le32 bld_tmstamp;
853 __le32 plat_id;
854 __le32 hw_ver;
855 __le16 ql_proto_ver;
856 u8 num_mac;
857 u8 mac_bitmap;
858 u8 total_tx_chain;
859 u8 total_rx_chain;
860 u8 info[0];
861 } __packed;
862
863 /**
864 * struct qlink_resp_manage_intf - response for interface management commands
865 *
866 * Response data for QLINK_CMD_ADD_INTF and QLINK_CMD_CHANGE_INTF commands.
867 *
868 * @rhdr: Common Command Response message header.
869 * @intf_info: interface description.
870 */
871 struct qlink_resp_manage_intf {
872 struct qlink_resp rhdr;
873 struct qlink_intf_info intf_info;
874 } __packed;
875
876 enum qlink_sta_info_rate_flags {
877 QLINK_STA_INFO_RATE_FLAG_HT_MCS = BIT(0),
878 QLINK_STA_INFO_RATE_FLAG_VHT_MCS = BIT(1),
879 QLINK_STA_INFO_RATE_FLAG_SHORT_GI = BIT(2),
880 QLINK_STA_INFO_RATE_FLAG_60G = BIT(3),
881 };
882
883 /**
884 * struct qlink_resp_get_sta_info - response for QLINK_CMD_GET_STA_INFO command
885 *
886 * Response data containing statistics for specified STA.
887 *
888 * @filled: a bitmask of &enum qlink_sta_info, specifies which info in response
889 * is valid.
890 * @sta_addr: MAC address of STA the response carries statistic for.
891 * @info: variable statistics for specified STA.
892 */
893 struct qlink_resp_get_sta_info {
894 struct qlink_resp rhdr;
895 u8 sta_addr[ETH_ALEN];
896 u8 rsvd[2];
897 u8 info[0];
898 } __packed;
899
900 /**
901 * struct qlink_resp_band_info_get - response for QLINK_CMD_BAND_INFO_GET cmd
902 *
903 * @band: frequency band that the response describes, one of @enum qlink_band.
904 * @num_chans: total number of channels info TLVs contained in reply.
905 * @num_bitrates: total number of bitrate TLVs contained in reply.
906 * @info: variable-length info portion.
907 */
908 struct qlink_resp_band_info_get {
909 struct qlink_resp rhdr;
910 u8 band;
911 u8 num_chans;
912 u8 num_bitrates;
913 u8 rsvd[1];
914 u8 info[0];
915 } __packed;
916
917 /**
918 * struct qlink_resp_phy_params - response for QLINK_CMD_PHY_PARAMS_GET command
919 *
920 * @info: variable-length array of PHY params.
921 */
922 struct qlink_resp_phy_params {
923 struct qlink_resp rhdr;
924 u8 info[0];
925 } __packed;
926
927 /**
928 * struct qlink_resp_get_chan_stats - response for QLINK_CMD_CHAN_STATS cmd
929 *
930 * @info: variable-length channel info.
931 */
932 struct qlink_resp_get_chan_stats {
933 struct qlink_cmd rhdr;
934 u8 info[0];
935 } __packed;
936
937 /**
938 * struct qlink_resp_channel_get - response for QLINK_CMD_CHAN_GET command
939 *
940 * @chan: definition of current operating channel.
941 */
942 struct qlink_resp_channel_get {
943 struct qlink_resp rhdr;
944 struct qlink_chandef chan;
945 } __packed;
946
947 /* QLINK Events messages related definitions
948 */
949
950 enum qlink_event_type {
951 QLINK_EVENT_STA_ASSOCIATED = 0x0021,
952 QLINK_EVENT_STA_DEAUTH = 0x0022,
953 QLINK_EVENT_MGMT_RECEIVED = 0x0023,
954 QLINK_EVENT_SCAN_RESULTS = 0x0024,
955 QLINK_EVENT_SCAN_COMPLETE = 0x0025,
956 QLINK_EVENT_BSS_JOIN = 0x0026,
957 QLINK_EVENT_BSS_LEAVE = 0x0027,
958 QLINK_EVENT_FREQ_CHANGE = 0x0028,
959 QLINK_EVENT_RADAR = 0x0029,
960 QLINK_EVENT_EXTERNAL_AUTH = 0x0030,
961 };
962
963 /**
964 * struct qlink_event - QLINK event message header
965 *
966 * Header used for QLINK messages of QLINK_MSG_TYPE_EVENT type.
967 *
968 * @mhdr: Common QLINK message header.
969 * @event_id: Specifies specific event ID, one of &enum qlink_event_type.
970 * @macid: index of physical radio device the event was generated on or
971 * QLINK_MACID_RSVD if not applicable.
972 * @vifid: index of virtual wireless interface on specified @macid the event
973 * was generated on or QLINK_VIFID_RSVD if not applicable.
974 */
975 struct qlink_event {
976 struct qlink_msg_header mhdr;
977 __le16 event_id;
978 u8 macid;
979 u8 vifid;
980 } __packed;
981
982 /**
983 * struct qlink_event_sta_assoc - data for QLINK_EVENT_STA_ASSOCIATED event
984 *
985 * @sta_addr: Address of a STA for which new association event was generated
986 * @frame_control: control bits from 802.11 ASSOC_REQUEST header.
987 * @payload: IEs from association request.
988 */
989 struct qlink_event_sta_assoc {
990 struct qlink_event ehdr;
991 u8 sta_addr[ETH_ALEN];
992 __le16 frame_control;
993 u8 ies[0];
994 } __packed;
995
996 /**
997 * struct qlink_event_sta_deauth - data for QLINK_EVENT_STA_DEAUTH event
998 *
999 * @sta_addr: Address of a deauthenticated STA.
1000 * @reason: reason for deauthentication.
1001 */
1002 struct qlink_event_sta_deauth {
1003 struct qlink_event ehdr;
1004 u8 sta_addr[ETH_ALEN];
1005 __le16 reason;
1006 } __packed;
1007
1008 /**
1009 * struct qlink_event_bss_join - data for QLINK_EVENT_BSS_JOIN event
1010 *
1011 * @chan: new operating channel definition
1012 * @bssid: BSSID of a BSS which interface tried to joined.
1013 * @status: status of joining attempt, see &enum ieee80211_statuscode.
1014 */
1015 struct qlink_event_bss_join {
1016 struct qlink_event ehdr;
1017 struct qlink_chandef chan;
1018 u8 bssid[ETH_ALEN];
1019 __le16 status;
1020 u8 ies[0];
1021 } __packed;
1022
1023 /**
1024 * struct qlink_event_bss_leave - data for QLINK_EVENT_BSS_LEAVE event
1025 *
1026 * @reason: reason of disconnecting from BSS.
1027 */
1028 struct qlink_event_bss_leave {
1029 struct qlink_event ehdr;
1030 __le16 reason;
1031 } __packed;
1032
1033 /**
1034 * struct qlink_event_freq_change - data for QLINK_EVENT_FREQ_CHANGE event
1035 *
1036 * @chan: new operating channel definition
1037 */
1038 struct qlink_event_freq_change {
1039 struct qlink_event ehdr;
1040 struct qlink_chandef chan;
1041 } __packed;
1042
1043 enum qlink_rxmgmt_flags {
1044 QLINK_RXMGMT_FLAG_ANSWERED = 1 << 0,
1045 };
1046
1047 /**
1048 * struct qlink_event_rxmgmt - data for QLINK_EVENT_MGMT_RECEIVED event
1049 *
1050 * @freq: Frequency on which the frame was received in MHz.
1051 * @flags: bitmap of &enum qlink_rxmgmt_flags.
1052 * @sig_dbm: signal strength in dBm.
1053 * @frame_data: data of Rx'd frame itself.
1054 */
1055 struct qlink_event_rxmgmt {
1056 struct qlink_event ehdr;
1057 __le32 freq;
1058 __le32 flags;
1059 s8 sig_dbm;
1060 u8 rsvd[3];
1061 u8 frame_data[0];
1062 } __packed;
1063
1064 /**
1065 * struct qlink_event_scan_result - data for QLINK_EVENT_SCAN_RESULTS event
1066 *
1067 * @tsf: TSF timestamp indicating when scan results were generated.
1068 * @freq: Center frequency of the channel where BSS for which the scan result
1069 * event was generated was discovered.
1070 * @capab: capabilities field.
1071 * @bintval: beacon interval announced by discovered BSS.
1072 * @sig_dbm: signal strength in dBm.
1073 * @bssid: BSSID announced by discovered BSS.
1074 * @ssid_len: length of SSID announced by BSS.
1075 * @ssid: SSID announced by discovered BSS.
1076 * @payload: IEs that are announced by discovered BSS in its MGMt frames.
1077 */
1078 struct qlink_event_scan_result {
1079 struct qlink_event ehdr;
1080 __le64 tsf;
1081 __le16 freq;
1082 __le16 capab;
1083 __le16 bintval;
1084 s8 sig_dbm;
1085 u8 ssid_len;
1086 u8 ssid[IEEE80211_MAX_SSID_LEN];
1087 u8 bssid[ETH_ALEN];
1088 u8 rsvd[2];
1089 u8 payload[0];
1090 } __packed;
1091
1092 /**
1093 * enum qlink_scan_complete_flags - indicates result of scan request.
1094 *
1095 * @QLINK_SCAN_NONE: Scan request was processed.
1096 * @QLINK_SCAN_ABORTED: Scan was aborted.
1097 */
1098 enum qlink_scan_complete_flags {
1099 QLINK_SCAN_NONE = 0,
1100 QLINK_SCAN_ABORTED = BIT(0),
1101 };
1102
1103 /**
1104 * struct qlink_event_scan_complete - data for QLINK_EVENT_SCAN_COMPLETE event
1105 *
1106 * @flags: flags indicating the status of pending scan request,
1107 * see &enum qlink_scan_complete_flags.
1108 */
1109 struct qlink_event_scan_complete {
1110 struct qlink_event ehdr;
1111 __le32 flags;
1112 } __packed;
1113
1114 enum qlink_radar_event {
1115 QLINK_RADAR_DETECTED,
1116 QLINK_RADAR_CAC_FINISHED,
1117 QLINK_RADAR_CAC_ABORTED,
1118 QLINK_RADAR_NOP_FINISHED,
1119 QLINK_RADAR_PRE_CAC_EXPIRED,
1120 QLINK_RADAR_CAC_STARTED,
1121 };
1122
1123 /**
1124 * struct qlink_event_radar - data for QLINK_EVENT_RADAR event
1125 *
1126 * @chan: channel on which radar event happened.
1127 * @event: radar event type, one of &enum qlink_radar_event.
1128 */
1129 struct qlink_event_radar {
1130 struct qlink_event ehdr;
1131 struct qlink_chandef chan;
1132 u8 event;
1133 u8 rsvd[3];
1134 } __packed;
1135
1136 /**
1137 * struct qlink_event_external_auth - data for QLINK_EVENT_EXTERNAL_AUTH event
1138 *
1139 * @ssid: SSID announced by BSS
1140 * @ssid_len: SSID length
1141 * @bssid: BSSID of the BSS to connect to
1142 * @akm_suite: AKM suite for external authentication
1143 * @action: action type/trigger for external authentication
1144 */
1145 struct qlink_event_external_auth {
1146 struct qlink_event ehdr;
1147 u8 ssid[IEEE80211_MAX_SSID_LEN];
1148 u8 ssid_len;
1149 u8 bssid[ETH_ALEN];
1150 __le32 akm_suite;
1151 u8 action;
1152 } __packed;
1153
1154 /* QLINK TLVs (Type-Length Values) definitions
1155 */
1156
1157 /**
1158 * enum qlink_tlv_id - list of TLVs that Qlink messages can carry
1159 *
1160 * @QTN_TLV_ID_STA_STATS_MAP: a bitmap of &enum qlink_sta_info, used to
1161 * indicate which statistic carried in QTN_TLV_ID_STA_STATS is valid.
1162 * @QTN_TLV_ID_STA_STATS: per-STA statistics as defined by
1163 * &struct qlink_sta_stats. Valid values are marked as such in a bitmap
1164 * carried by QTN_TLV_ID_STA_STATS_MAP.
1165 * @QTN_TLV_ID_MAX_SCAN_SSIDS: maximum number of SSIDs the device can scan
1166 * for in any given scan.
1167 * @QTN_TLV_ID_SCAN_DWELL_ACTIVE: time spent on a single channel for an active
1168 * scan.
1169 * @QTN_TLV_ID_SCAN_DWELL_PASSIVE: time spent on a single channel for a passive
1170 * scan.
1171 * @QTN_TLV_ID_SCAN_SAMPLE_DURATION: total duration of sampling a single channel
1172 * during a scan including off-channel dwell time and operating channel
1173 * time.
1174 */
1175 enum qlink_tlv_id {
1176 QTN_TLV_ID_FRAG_THRESH = 0x0201,
1177 QTN_TLV_ID_RTS_THRESH = 0x0202,
1178 QTN_TLV_ID_SRETRY_LIMIT = 0x0203,
1179 QTN_TLV_ID_LRETRY_LIMIT = 0x0204,
1180 QTN_TLV_ID_REG_RULE = 0x0207,
1181 QTN_TLV_ID_CHANNEL = 0x020F,
1182 QTN_TLV_ID_CHANDEF = 0x0210,
1183 QTN_TLV_ID_STA_STATS_MAP = 0x0211,
1184 QTN_TLV_ID_STA_STATS = 0x0212,
1185 QTN_TLV_ID_COVERAGE_CLASS = 0x0213,
1186 QTN_TLV_ID_IFACE_LIMIT = 0x0214,
1187 QTN_TLV_ID_NUM_IFACE_COMB = 0x0215,
1188 QTN_TLV_ID_CHANNEL_STATS = 0x0216,
1189 QTN_TLV_ID_KEY = 0x0302,
1190 QTN_TLV_ID_SEQ = 0x0303,
1191 QTN_TLV_ID_IE_SET = 0x0305,
1192 QTN_TLV_ID_EXT_CAPABILITY_MASK = 0x0306,
1193 QTN_TLV_ID_ACL_DATA = 0x0307,
1194 QTN_TLV_ID_BUILD_NAME = 0x0401,
1195 QTN_TLV_ID_BUILD_REV = 0x0402,
1196 QTN_TLV_ID_BUILD_TYPE = 0x0403,
1197 QTN_TLV_ID_BUILD_LABEL = 0x0404,
1198 QTN_TLV_ID_HW_ID = 0x0405,
1199 QTN_TLV_ID_CALIBRATION_VER = 0x0406,
1200 QTN_TLV_ID_UBOOT_VER = 0x0407,
1201 QTN_TLV_ID_RANDOM_MAC_ADDR = 0x0408,
1202 QTN_TLV_ID_MAX_SCAN_SSIDS = 0x0409,
1203 QTN_TLV_ID_WOWLAN_CAPAB = 0x0410,
1204 QTN_TLV_ID_WOWLAN_PATTERN = 0x0411,
1205 QTN_TLV_ID_SCAN_FLUSH = 0x0412,
1206 QTN_TLV_ID_SCAN_DWELL_ACTIVE = 0x0413,
1207 QTN_TLV_ID_SCAN_DWELL_PASSIVE = 0x0416,
1208 QTN_TLV_ID_SCAN_SAMPLE_DURATION = 0x0417,
1209 };
1210
1211 struct qlink_tlv_hdr {
1212 __le16 type;
1213 __le16 len;
1214 u8 val[0];
1215 } __packed;
1216
1217 struct qlink_iface_comb_num {
1218 __le32 iface_comb_num;
1219 } __packed;
1220
1221 struct qlink_iface_limit {
1222 __le16 max_num;
1223 __le16 type;
1224 } __packed;
1225
1226 struct qlink_iface_limit_record {
1227 __le16 max_interfaces;
1228 u8 num_different_channels;
1229 u8 n_limits;
1230 struct qlink_iface_limit limits[0];
1231 } __packed;
1232
1233 #define QLINK_RSSI_OFFSET 120
1234
1235 struct qlink_tlv_frag_rts_thr {
1236 struct qlink_tlv_hdr hdr;
1237 __le32 thr;
1238 } __packed;
1239
1240 struct qlink_tlv_rlimit {
1241 struct qlink_tlv_hdr hdr;
1242 u8 rlimit;
1243 } __packed;
1244
1245 struct qlink_tlv_cclass {
1246 struct qlink_tlv_hdr hdr;
1247 u8 cclass;
1248 } __packed;
1249
1250 /**
1251 * enum qlink_reg_rule_flags - regulatory rule flags
1252 *
1253 * See description of &enum nl80211_reg_rule_flags
1254 */
1255 enum qlink_reg_rule_flags {
1256 QLINK_RRF_NO_OFDM = BIT(0),
1257 QLINK_RRF_NO_CCK = BIT(1),
1258 QLINK_RRF_NO_INDOOR = BIT(2),
1259 QLINK_RRF_NO_OUTDOOR = BIT(3),
1260 QLINK_RRF_DFS = BIT(4),
1261 QLINK_RRF_PTP_ONLY = BIT(5),
1262 QLINK_RRF_PTMP_ONLY = BIT(6),
1263 QLINK_RRF_NO_IR = BIT(7),
1264 QLINK_RRF_AUTO_BW = BIT(8),
1265 QLINK_RRF_IR_CONCURRENT = BIT(9),
1266 QLINK_RRF_NO_HT40MINUS = BIT(10),
1267 QLINK_RRF_NO_HT40PLUS = BIT(11),
1268 QLINK_RRF_NO_80MHZ = BIT(12),
1269 QLINK_RRF_NO_160MHZ = BIT(13),
1270 };
1271
1272 /**
1273 * struct qlink_tlv_reg_rule - data for QTN_TLV_ID_REG_RULE TLV
1274 *
1275 * Regulatory rule description.
1276 *
1277 * @start_freq_khz: start frequency of the range the rule is attributed to.
1278 * @end_freq_khz: end frequency of the range the rule is attributed to.
1279 * @max_bandwidth_khz: max bandwidth that channels in specified range can be
1280 * configured to.
1281 * @max_antenna_gain: max antenna gain that can be used in the specified
1282 * frequency range, dBi.
1283 * @max_eirp: maximum EIRP.
1284 * @flags: regulatory rule flags in &enum qlink_reg_rule_flags.
1285 * @dfs_cac_ms: DFS CAC period.
1286 */
1287 struct qlink_tlv_reg_rule {
1288 struct qlink_tlv_hdr hdr;
1289 __le32 start_freq_khz;
1290 __le32 end_freq_khz;
1291 __le32 max_bandwidth_khz;
1292 __le32 max_antenna_gain;
1293 __le32 max_eirp;
1294 __le32 flags;
1295 __le32 dfs_cac_ms;
1296 } __packed;
1297
1298 enum qlink_channel_flags {
1299 QLINK_CHAN_DISABLED = BIT(0),
1300 QLINK_CHAN_NO_IR = BIT(1),
1301 QLINK_CHAN_RADAR = BIT(3),
1302 QLINK_CHAN_NO_HT40PLUS = BIT(4),
1303 QLINK_CHAN_NO_HT40MINUS = BIT(5),
1304 QLINK_CHAN_NO_OFDM = BIT(6),
1305 QLINK_CHAN_NO_80MHZ = BIT(7),
1306 QLINK_CHAN_NO_160MHZ = BIT(8),
1307 QLINK_CHAN_INDOOR_ONLY = BIT(9),
1308 QLINK_CHAN_IR_CONCURRENT = BIT(10),
1309 QLINK_CHAN_NO_20MHZ = BIT(11),
1310 QLINK_CHAN_NO_10MHZ = BIT(12),
1311 };
1312
1313 enum qlink_dfs_state {
1314 QLINK_DFS_USABLE,
1315 QLINK_DFS_UNAVAILABLE,
1316 QLINK_DFS_AVAILABLE,
1317 };
1318
1319 /**
1320 * struct qlink_tlv_channel - data for QTN_TLV_ID_CHANNEL TLV
1321 *
1322 * Channel settings.
1323 *
1324 * @channel: ieee80211 channel settings.
1325 */
1326 struct qlink_tlv_channel {
1327 struct qlink_tlv_hdr hdr;
1328 struct qlink_channel chan;
1329 } __packed;
1330
1331 /**
1332 * struct qlink_tlv_chandef - data for QTN_TLV_ID_CHANDEF TLV
1333 *
1334 * Channel definition.
1335 *
1336 * @chan: channel definition data.
1337 */
1338 struct qlink_tlv_chandef {
1339 struct qlink_tlv_hdr hdr;
1340 struct qlink_chandef chdef;
1341 } __packed;
1342
1343 enum qlink_ie_set_type {
1344 QLINK_IE_SET_UNKNOWN,
1345 QLINK_IE_SET_ASSOC_REQ,
1346 QLINK_IE_SET_ASSOC_RESP,
1347 QLINK_IE_SET_PROBE_REQ,
1348 QLINK_IE_SET_SCAN,
1349 QLINK_IE_SET_BEACON_HEAD,
1350 QLINK_IE_SET_BEACON_TAIL,
1351 QLINK_IE_SET_BEACON_IES,
1352 QLINK_IE_SET_PROBE_RESP,
1353 QLINK_IE_SET_PROBE_RESP_IES,
1354 };
1355
1356 /**
1357 * struct qlink_tlv_ie_set - data for QTN_TLV_ID_IE_SET
1358 *
1359 * @type: type of MGMT frame IEs belong to, one of &enum qlink_ie_set_type.
1360 * @flags: for future use.
1361 * @ie_data: IEs data.
1362 */
1363 struct qlink_tlv_ie_set {
1364 struct qlink_tlv_hdr hdr;
1365 u8 type;
1366 u8 flags;
1367 u8 ie_data[0];
1368 } __packed;
1369
1370 struct qlink_chan_stats {
1371 __le32 chan_num;
1372 __le32 cca_tx;
1373 __le32 cca_rx;
1374 __le32 cca_busy;
1375 __le32 cca_try;
1376 s8 chan_noise;
1377 } __packed;
1378
1379 /**
1380 * enum qlink_sta_info - station information bitmap
1381 *
1382 * Used to indicate which statistics values in &struct qlink_sta_stats
1383 * are valid. Individual values are used to fill a bitmap carried in a
1384 * payload of QTN_TLV_ID_STA_STATS_MAP.
1385 *
1386 * @QLINK_STA_INFO_CONNECTED_TIME: connected_time value is valid.
1387 * @QLINK_STA_INFO_INACTIVE_TIME: inactive_time value is valid.
1388 * @QLINK_STA_INFO_RX_BYTES: lower 32 bits of rx_bytes value are valid.
1389 * @QLINK_STA_INFO_TX_BYTES: lower 32 bits of tx_bytes value are valid.
1390 * @QLINK_STA_INFO_RX_BYTES64: rx_bytes value is valid.
1391 * @QLINK_STA_INFO_TX_BYTES64: tx_bytes value is valid.
1392 * @QLINK_STA_INFO_RX_DROP_MISC: rx_dropped_misc value is valid.
1393 * @QLINK_STA_INFO_BEACON_RX: rx_beacon value is valid.
1394 * @QLINK_STA_INFO_SIGNAL: signal value is valid.
1395 * @QLINK_STA_INFO_SIGNAL_AVG: signal_avg value is valid.
1396 * @QLINK_STA_INFO_RX_BITRATE: rxrate value is valid.
1397 * @QLINK_STA_INFO_TX_BITRATE: txrate value is valid.
1398 * @QLINK_STA_INFO_RX_PACKETS: rx_packets value is valid.
1399 * @QLINK_STA_INFO_TX_PACKETS: tx_packets value is valid.
1400 * @QLINK_STA_INFO_TX_RETRIES: tx_retries value is valid.
1401 * @QLINK_STA_INFO_TX_FAILED: tx_failed value is valid.
1402 * @QLINK_STA_INFO_STA_FLAGS: sta_flags value is valid.
1403 */
1404 enum qlink_sta_info {
1405 QLINK_STA_INFO_CONNECTED_TIME,
1406 QLINK_STA_INFO_INACTIVE_TIME,
1407 QLINK_STA_INFO_RX_BYTES,
1408 QLINK_STA_INFO_TX_BYTES,
1409 QLINK_STA_INFO_RX_BYTES64,
1410 QLINK_STA_INFO_TX_BYTES64,
1411 QLINK_STA_INFO_RX_DROP_MISC,
1412 QLINK_STA_INFO_BEACON_RX,
1413 QLINK_STA_INFO_SIGNAL,
1414 QLINK_STA_INFO_SIGNAL_AVG,
1415 QLINK_STA_INFO_RX_BITRATE,
1416 QLINK_STA_INFO_TX_BITRATE,
1417 QLINK_STA_INFO_RX_PACKETS,
1418 QLINK_STA_INFO_TX_PACKETS,
1419 QLINK_STA_INFO_TX_RETRIES,
1420 QLINK_STA_INFO_TX_FAILED,
1421 QLINK_STA_INFO_STA_FLAGS,
1422 QLINK_STA_INFO_NUM,
1423 };
1424
1425 /**
1426 * struct qlink_sta_info_rate - STA rate statistics
1427 *
1428 * @rate: data rate in Mbps.
1429 * @flags: bitmap of &enum qlink_sta_info_rate_flags.
1430 * @mcs: 802.11-defined MCS index.
1431 * nss: Number of Spatial Streams.
1432 * @bw: bandwidth, one of &enum qlink_channel_width.
1433 */
1434 struct qlink_sta_info_rate {
1435 __le16 rate;
1436 u8 flags;
1437 u8 mcs;
1438 u8 nss;
1439 u8 bw;
1440 } __packed;
1441
1442 /**
1443 * struct qlink_sta_stats - data for QTN_TLV_ID_STA_STATS
1444 *
1445 * Carries statistics of a STA. Not all fields may be filled with
1446 * valid values. Valid fields should be indicated as such using a bitmap of
1447 * &enum qlink_sta_info. Bitmap is carried separately in a payload of
1448 * QTN_TLV_ID_STA_STATS_MAP.
1449 */
1450 struct qlink_sta_stats {
1451 __le64 rx_bytes;
1452 __le64 tx_bytes;
1453 __le64 rx_beacon;
1454 __le64 rx_duration;
1455 __le64 t_offset;
1456 __le32 connected_time;
1457 __le32 inactive_time;
1458 __le32 rx_packets;
1459 __le32 tx_packets;
1460 __le32 tx_retries;
1461 __le32 tx_failed;
1462 __le32 rx_dropped_misc;
1463 __le32 beacon_loss_count;
1464 __le32 expected_throughput;
1465 struct qlink_sta_info_state sta_flags;
1466 struct qlink_sta_info_rate txrate;
1467 struct qlink_sta_info_rate rxrate;
1468 __le16 llid;
1469 __le16 plid;
1470 u8 local_pm;
1471 u8 peer_pm;
1472 u8 nonpeer_pm;
1473 u8 rx_beacon_signal_avg;
1474 u8 plink_state;
1475 u8 signal;
1476 u8 signal_avg;
1477 u8 rsvd[1];
1478 };
1479
1480 /**
1481 * struct qlink_random_mac_addr - data for QTN_TLV_ID_RANDOM_MAC_ADDR TLV
1482 *
1483 * Specifies MAC address mask/value for generation random MAC address
1484 * during scan.
1485 *
1486 * @mac_addr: MAC address used with randomisation
1487 * @mac_addr_mask: MAC address mask used with randomisation, bits that
1488 * are 0 in the mask should be randomised, bits that are 1 should
1489 * be taken from the @mac_addr
1490 */
1491 struct qlink_random_mac_addr {
1492 u8 mac_addr[ETH_ALEN];
1493 u8 mac_addr_mask[ETH_ALEN];
1494 } __packed;
1495
1496 /**
1497 * struct qlink_wowlan_capab_data - data for QTN_TLV_ID_WOWLAN_CAPAB TLV
1498 *
1499 * WoWLAN capabilities supported by cards.
1500 *
1501 * @version: version of WoWLAN data structure, to ensure backward
1502 * compatibility for firmwares with limited WoWLAN support
1503 * @len: Total length of WoWLAN data
1504 * @data: supported WoWLAN features
1505 */
1506 struct qlink_wowlan_capab_data {
1507 __le16 version;
1508 __le16 len;
1509 u8 data[0];
1510 } __packed;
1511
1512 /**
1513 * struct qlink_wowlan_support - supported WoWLAN capabilities
1514 *
1515 * @n_patterns: number of supported wakeup patterns
1516 * @pattern_max_len: maximum length of each pattern
1517 * @pattern_min_len: minimum length of each pattern
1518 */
1519 struct qlink_wowlan_support {
1520 __le32 n_patterns;
1521 __le32 pattern_max_len;
1522 __le32 pattern_min_len;
1523 } __packed;
1524
1525 #endif /* _QTN_QLINK_H_ */