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 */ 42 enum 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 */ 56 struct 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 */ 77 enum 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 */ 94 enum qlink_driver_capab { 95 QLINK_DRV_CAPAB_NUM = 0 96 }; 97 98 enum 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 */ 116 struct 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 124 enum 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 135 enum 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 */ 162 struct 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 */ 184 struct 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 195 struct 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 */ 216 struct 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 */ 234 enum 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 */ 253 struct 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 */ 288 enum 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 */ 342 struct 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 */ 362 struct 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 */ 376 struct qlink_cmd_manage_intf { 377 struct qlink_cmd chdr; 378 struct qlink_intf_info intf_info; 379 } __packed; 380 381 enum 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 */ 406 struct 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 */ 417 enum 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 */ 432 struct 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 */ 445 struct 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 */ 461 struct 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 */ 479 struct 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 */ 493 struct 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 */ 506 struct 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 */ 520 struct 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 */ 534 struct 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 542 enum 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 */ 566 struct 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 */ 591 struct 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 */ 603 struct 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 */ 615 struct 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 */ 628 enum 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 */ 639 struct 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 */ 650 struct 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 */ 660 enum 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 */ 672 enum 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 */ 692 struct 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 */ 712 enum 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 */ 724 struct 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 */ 739 enum 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 */ 760 struct 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 */ 785 struct qlink_cmd_start_cac { 786 struct qlink_cmd chdr; 787 struct qlink_chandef chan; 788 __le32 cac_time_ms; 789 } __packed; 790 791 enum qlink_acl_policy { 792 QLINK_ACL_POLICY_ACCEPT_UNLESS_LISTED, 793 QLINK_ACL_POLICY_DENY_UNLESS_LISTED, 794 }; 795 796 struct 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 */ 807 struct 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 */ 819 enum 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 */ 831 struct 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 */ 843 enum 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 */ 856 struct 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 */ 871 enum 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 */ 882 struct qlink_cmd_wowlan_set { 883 struct qlink_cmd chdr; 884 __le32 triggers; 885 u8 data[]; 886 } __packed; 887 888 enum 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 */ 897 struct qlink_cmd_ndev_event { 898 struct qlink_cmd chdr; 899 __le16 event; 900 u8 rsvd[2]; 901 } __packed; 902 903 enum 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 */ 914 struct 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 */ 931 enum 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 */ 950 struct 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 */ 971 struct 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 981 enum 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 */ 1007 struct 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 */ 1021 struct 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 */ 1031 enum 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 */ 1060 struct 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 */ 1124 struct 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 */ 1145 struct qlink_resp_manage_intf { 1146 struct qlink_resp rhdr; 1147 struct qlink_intf_info intf_info; 1148 } __packed; 1149 1150 enum 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 */ 1166 struct 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 */ 1181 struct 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 */ 1196 struct 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 */ 1207 struct 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 */ 1220 struct qlink_resp_txpwr { 1221 struct qlink_resp rhdr; 1222 __le32 txpwr; 1223 } __packed; 1224 1225 /* QLINK Events messages related definitions 1226 */ 1227 1228 enum 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 */ 1255 struct 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 */ 1269 struct 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 */ 1282 struct 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 */ 1295 struct 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 */ 1308 struct 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 */ 1319 struct qlink_event_freq_change { 1320 struct qlink_event ehdr; 1321 struct qlink_chandef chan; 1322 } __packed; 1323 1324 enum 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 */ 1336 struct 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 */ 1359 struct 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 */ 1379 enum 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 */ 1390 struct qlink_event_scan_complete { 1391 struct qlink_event ehdr; 1392 __le32 flags; 1393 } __packed; 1394 1395 enum 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 */ 1410 struct 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 */ 1426 struct 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 */ 1442 struct 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 */ 1455 struct 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 */ 1481 enum 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 1512 struct qlink_tlv_hdr { 1513 /* New members MUST be added within the struct_group() macro below. */ 1514 __struct_group(qlink_tlv_hdr_fixed, __hdr, __packed, 1515 __le16 type; 1516 __le16 len; 1517 ); 1518 u8 val[]; 1519 } __packed; 1520 static_assert(offsetof(struct qlink_tlv_hdr, val) == sizeof(struct qlink_tlv_hdr_fixed), 1521 "struct member likely outside of __struct_group()"); 1522 1523 struct qlink_iface_limit { 1524 __le16 max_num; 1525 __le16 type; 1526 } __packed; 1527 1528 struct qlink_iface_limit_record { 1529 __le16 max_interfaces; 1530 u8 num_different_channels; 1531 u8 n_limits; 1532 struct qlink_iface_limit limits[]; 1533 } __packed; 1534 1535 #define QLINK_RSSI_OFFSET 120 1536 1537 /** 1538 * enum qlink_reg_rule_flags - regulatory rule flags 1539 * 1540 * See description of &enum nl80211_reg_rule_flags 1541 */ 1542 enum qlink_reg_rule_flags { 1543 QLINK_RRF_NO_OFDM = BIT(0), 1544 QLINK_RRF_NO_CCK = BIT(1), 1545 QLINK_RRF_NO_INDOOR = BIT(2), 1546 QLINK_RRF_NO_OUTDOOR = BIT(3), 1547 QLINK_RRF_DFS = BIT(4), 1548 QLINK_RRF_PTP_ONLY = BIT(5), 1549 QLINK_RRF_PTMP_ONLY = BIT(6), 1550 QLINK_RRF_NO_IR = BIT(7), 1551 QLINK_RRF_AUTO_BW = BIT(8), 1552 QLINK_RRF_IR_CONCURRENT = BIT(9), 1553 QLINK_RRF_NO_HT40MINUS = BIT(10), 1554 QLINK_RRF_NO_HT40PLUS = BIT(11), 1555 QLINK_RRF_NO_80MHZ = BIT(12), 1556 QLINK_RRF_NO_160MHZ = BIT(13), 1557 }; 1558 1559 /** 1560 * struct qlink_tlv_reg_rule - data for QTN_TLV_ID_REG_RULE TLV 1561 * 1562 * Regulatory rule description. 1563 * 1564 * @start_freq_khz: start frequency of the range the rule is attributed to. 1565 * @end_freq_khz: end frequency of the range the rule is attributed to. 1566 * @max_bandwidth_khz: max bandwidth that channels in specified range can be 1567 * configured to. 1568 * @max_antenna_gain: max antenna gain that can be used in the specified 1569 * frequency range, dBi. 1570 * @max_eirp: maximum EIRP. 1571 * @flags: regulatory rule flags in &enum qlink_reg_rule_flags. 1572 * @dfs_cac_ms: DFS CAC period. 1573 */ 1574 struct qlink_tlv_reg_rule { 1575 struct qlink_tlv_hdr_fixed hdr; 1576 __le32 start_freq_khz; 1577 __le32 end_freq_khz; 1578 __le32 max_bandwidth_khz; 1579 __le32 max_antenna_gain; 1580 __le32 max_eirp; 1581 __le32 flags; 1582 __le32 dfs_cac_ms; 1583 } __packed; 1584 1585 enum qlink_channel_flags { 1586 QLINK_CHAN_DISABLED = BIT(0), 1587 QLINK_CHAN_NO_IR = BIT(1), 1588 QLINK_CHAN_RADAR = BIT(3), 1589 QLINK_CHAN_NO_HT40PLUS = BIT(4), 1590 QLINK_CHAN_NO_HT40MINUS = BIT(5), 1591 QLINK_CHAN_NO_OFDM = BIT(6), 1592 QLINK_CHAN_NO_80MHZ = BIT(7), 1593 QLINK_CHAN_NO_160MHZ = BIT(8), 1594 QLINK_CHAN_INDOOR_ONLY = BIT(9), 1595 QLINK_CHAN_IR_CONCURRENT = BIT(10), 1596 QLINK_CHAN_NO_20MHZ = BIT(11), 1597 QLINK_CHAN_NO_10MHZ = BIT(12), 1598 }; 1599 1600 enum qlink_dfs_state { 1601 QLINK_DFS_USABLE, 1602 QLINK_DFS_UNAVAILABLE, 1603 QLINK_DFS_AVAILABLE, 1604 }; 1605 1606 /** 1607 * struct qlink_tlv_channel - data for QTN_TLV_ID_CHANNEL TLV 1608 * 1609 * Channel settings. 1610 * 1611 * @channel: ieee80211 channel settings. 1612 */ 1613 struct qlink_tlv_channel { 1614 struct qlink_tlv_hdr_fixed hdr; 1615 struct qlink_channel chan; 1616 } __packed; 1617 1618 /** 1619 * struct qlink_tlv_chandef - data for QTN_TLV_ID_CHANDEF TLV 1620 * 1621 * Channel definition. 1622 * 1623 * @chan: channel definition data. 1624 */ 1625 struct qlink_tlv_chandef { 1626 struct qlink_tlv_hdr_fixed hdr; 1627 struct qlink_chandef chdef; 1628 } __packed; 1629 1630 enum qlink_ie_set_type { 1631 QLINK_IE_SET_UNKNOWN, 1632 QLINK_IE_SET_ASSOC_REQ, 1633 QLINK_IE_SET_ASSOC_RESP, 1634 QLINK_IE_SET_PROBE_REQ, 1635 QLINK_IE_SET_SCAN, 1636 QLINK_IE_SET_BEACON_HEAD, 1637 QLINK_IE_SET_BEACON_TAIL, 1638 QLINK_IE_SET_BEACON_IES, 1639 QLINK_IE_SET_PROBE_RESP, 1640 QLINK_IE_SET_PROBE_RESP_IES, 1641 }; 1642 1643 /** 1644 * struct qlink_tlv_ie_set - data for QTN_TLV_ID_IE_SET 1645 * 1646 * @type: type of MGMT frame IEs belong to, one of &enum qlink_ie_set_type. 1647 * @flags: for future use. 1648 * @ie_data: IEs data. 1649 */ 1650 struct qlink_tlv_ie_set { 1651 struct qlink_tlv_hdr_fixed hdr; 1652 u8 type; 1653 u8 flags; 1654 u8 rsvd[2]; 1655 u8 ie_data[]; 1656 } __packed; 1657 1658 /** 1659 * struct qlink_tlv_ext_ie - extension IE 1660 * 1661 * @eid_ext: element ID extension, one of &enum ieee80211_eid_ext. 1662 * @ie_data: IEs data. 1663 */ 1664 struct qlink_tlv_ext_ie { 1665 struct qlink_tlv_hdr_fixed hdr; 1666 u8 eid_ext; 1667 u8 rsvd[3]; 1668 u8 ie_data[]; 1669 } __packed; 1670 1671 #define IEEE80211_HE_PPE_THRES_MAX_LEN 25 1672 struct qlink_sband_iftype_data { 1673 __le16 types_mask; 1674 struct ieee80211_he_cap_elem he_cap_elem; 1675 struct ieee80211_he_mcs_nss_supp he_mcs_nss_supp; 1676 u8 ppe_thres[IEEE80211_HE_PPE_THRES_MAX_LEN]; 1677 } __packed; 1678 1679 /** 1680 * struct qlink_tlv_iftype_data - data for QTN_TLV_ID_IFTYPE_DATA 1681 * 1682 * @n_iftype_data: number of entries in iftype_data. 1683 * @iftype_data: interface type data entries. 1684 */ 1685 struct qlink_tlv_iftype_data { 1686 struct qlink_tlv_hdr_fixed hdr; 1687 u8 n_iftype_data; 1688 u8 rsvd[3]; 1689 struct qlink_sband_iftype_data iftype_data[]; 1690 } __packed; 1691 1692 /** 1693 * enum qlink_chan_stat - channel statistics bitmap 1694 * 1695 * Used to indicate which statistics values in &struct qlink_chan_stats 1696 * are valid. Individual values are used to fill a bitmap carried in a 1697 * payload of QTN_TLV_ID_BITMAP. 1698 * 1699 * @QLINK_CHAN_STAT_TIME_ON: time_on value is valid. 1700 * @QLINK_CHAN_STAT_TIME_TX: time_tx value is valid. 1701 * @QLINK_CHAN_STAT_TIME_RX: time_rx value is valid. 1702 * @QLINK_CHAN_STAT_CCA_BUSY: cca_busy value is valid. 1703 * @QLINK_CHAN_STAT_CCA_BUSY_EXT: cca_busy_ext value is valid. 1704 * @QLINK_CHAN_STAT_TIME_SCAN: time_scan value is valid. 1705 * @QLINK_CHAN_STAT_CHAN_NOISE: chan_noise value is valid. 1706 */ 1707 enum qlink_chan_stat { 1708 QLINK_CHAN_STAT_TIME_ON, 1709 QLINK_CHAN_STAT_TIME_TX, 1710 QLINK_CHAN_STAT_TIME_RX, 1711 QLINK_CHAN_STAT_CCA_BUSY, 1712 QLINK_CHAN_STAT_CCA_BUSY_EXT, 1713 QLINK_CHAN_STAT_TIME_SCAN, 1714 QLINK_CHAN_STAT_CHAN_NOISE, 1715 QLINK_CHAN_STAT_NUM, 1716 }; 1717 1718 /** 1719 * struct qlink_chan_stats - data for QTN_TLV_ID_CHANNEL_STATS 1720 * 1721 * Carries a per-channel statistics. Not all fields may be filled with 1722 * valid values. Valid fields should be indicated as such using a bitmap of 1723 * &enum qlink_chan_stat. Bitmap is carried separately in a payload of 1724 * QTN_TLV_ID_BITMAP. 1725 * 1726 * @time_on: amount of time radio operated on that channel. 1727 * @time_tx: amount of time radio spent transmitting on the channel. 1728 * @time_rx: amount of time radio spent receiving on the channel. 1729 * @cca_busy: amount of time the primary channel was busy. 1730 * @cca_busy_ext: amount of time the secondary channel was busy. 1731 * @time_scan: amount of radio spent scanning on the channel. 1732 * @chan_noise: channel noise. 1733 */ 1734 struct qlink_chan_stats { 1735 __le64 time_on; 1736 __le64 time_tx; 1737 __le64 time_rx; 1738 __le64 cca_busy; 1739 __le64 cca_busy_ext; 1740 __le64 time_scan; 1741 s8 chan_noise; 1742 u8 rsvd[3]; 1743 } __packed; 1744 1745 /** 1746 * enum qlink_sta_info - station information bitmap 1747 * 1748 * Used to indicate which statistics values in &struct qlink_sta_stats 1749 * are valid. Individual values are used to fill a bitmap carried in a 1750 * payload of QTN_TLV_ID_BITMAP. 1751 * 1752 * @QLINK_STA_INFO_CONNECTED_TIME: connected_time value is valid. 1753 * @QLINK_STA_INFO_INACTIVE_TIME: inactive_time value is valid. 1754 * @QLINK_STA_INFO_RX_BYTES: lower 32 bits of rx_bytes value are valid. 1755 * @QLINK_STA_INFO_TX_BYTES: lower 32 bits of tx_bytes value are valid. 1756 * @QLINK_STA_INFO_RX_BYTES64: rx_bytes value is valid. 1757 * @QLINK_STA_INFO_TX_BYTES64: tx_bytes value is valid. 1758 * @QLINK_STA_INFO_RX_DROP_MISC: rx_dropped_misc value is valid. 1759 * @QLINK_STA_INFO_BEACON_RX: rx_beacon value is valid. 1760 * @QLINK_STA_INFO_SIGNAL: signal value is valid. 1761 * @QLINK_STA_INFO_SIGNAL_AVG: signal_avg value is valid. 1762 * @QLINK_STA_INFO_RX_BITRATE: rxrate value is valid. 1763 * @QLINK_STA_INFO_TX_BITRATE: txrate value is valid. 1764 * @QLINK_STA_INFO_RX_PACKETS: rx_packets value is valid. 1765 * @QLINK_STA_INFO_TX_PACKETS: tx_packets value is valid. 1766 * @QLINK_STA_INFO_TX_RETRIES: tx_retries value is valid. 1767 * @QLINK_STA_INFO_TX_FAILED: tx_failed value is valid. 1768 * @QLINK_STA_INFO_STA_FLAGS: sta_flags value is valid. 1769 */ 1770 enum qlink_sta_info { 1771 QLINK_STA_INFO_CONNECTED_TIME, 1772 QLINK_STA_INFO_INACTIVE_TIME, 1773 QLINK_STA_INFO_RX_BYTES, 1774 QLINK_STA_INFO_TX_BYTES, 1775 QLINK_STA_INFO_RX_BYTES64, 1776 QLINK_STA_INFO_TX_BYTES64, 1777 QLINK_STA_INFO_RX_DROP_MISC, 1778 QLINK_STA_INFO_BEACON_RX, 1779 QLINK_STA_INFO_SIGNAL, 1780 QLINK_STA_INFO_SIGNAL_AVG, 1781 QLINK_STA_INFO_RX_BITRATE, 1782 QLINK_STA_INFO_TX_BITRATE, 1783 QLINK_STA_INFO_RX_PACKETS, 1784 QLINK_STA_INFO_TX_PACKETS, 1785 QLINK_STA_INFO_TX_RETRIES, 1786 QLINK_STA_INFO_TX_FAILED, 1787 QLINK_STA_INFO_STA_FLAGS, 1788 QLINK_STA_INFO_NUM, 1789 }; 1790 1791 /** 1792 * struct qlink_sta_info_rate - STA rate statistics 1793 * 1794 * @rate: data rate in Mbps. 1795 * @flags: bitmap of &enum qlink_sta_info_rate_flags. 1796 * @mcs: 802.11-defined MCS index. 1797 * nss: Number of Spatial Streams. 1798 * @bw: bandwidth, one of &enum qlink_channel_width. 1799 */ 1800 struct qlink_sta_info_rate { 1801 __le16 rate; 1802 u8 flags; 1803 u8 mcs; 1804 u8 nss; 1805 u8 bw; 1806 } __packed; 1807 1808 /** 1809 * struct qlink_sta_stats - data for QTN_TLV_ID_STA_STATS 1810 * 1811 * Carries statistics of a STA. Not all fields may be filled with 1812 * valid values. Valid fields should be indicated as such using a bitmap of 1813 * &enum qlink_sta_info. Bitmap is carried separately in a payload of 1814 * QTN_TLV_ID_BITMAP. 1815 */ 1816 struct qlink_sta_stats { 1817 __le64 rx_bytes; 1818 __le64 tx_bytes; 1819 __le64 rx_beacon; 1820 __le64 rx_duration; 1821 __le64 t_offset; 1822 __le32 connected_time; 1823 __le32 inactive_time; 1824 __le32 rx_packets; 1825 __le32 tx_packets; 1826 __le32 tx_retries; 1827 __le32 tx_failed; 1828 __le32 rx_dropped_misc; 1829 __le32 beacon_loss_count; 1830 __le32 expected_throughput; 1831 struct qlink_sta_info_state sta_flags; 1832 struct qlink_sta_info_rate txrate; 1833 struct qlink_sta_info_rate rxrate; 1834 __le16 llid; 1835 __le16 plid; 1836 u8 local_pm; 1837 u8 peer_pm; 1838 u8 nonpeer_pm; 1839 u8 rx_beacon_signal_avg; 1840 u8 plink_state; 1841 u8 signal; 1842 u8 signal_avg; 1843 u8 rsvd[1]; 1844 }; 1845 1846 /** 1847 * struct qlink_random_mac_addr - data for QTN_TLV_ID_RANDOM_MAC_ADDR TLV 1848 * 1849 * Specifies MAC address mask/value for generation random MAC address 1850 * during scan. 1851 * 1852 * @mac_addr: MAC address used with randomisation 1853 * @mac_addr_mask: MAC address mask used with randomisation, bits that 1854 * are 0 in the mask should be randomised, bits that are 1 should 1855 * be taken from the @mac_addr 1856 */ 1857 struct qlink_random_mac_addr { 1858 u8 mac_addr[ETH_ALEN]; 1859 u8 mac_addr_mask[ETH_ALEN]; 1860 } __packed; 1861 1862 /** 1863 * struct qlink_wowlan_capab_data - data for QTN_TLV_ID_WOWLAN_CAPAB TLV 1864 * 1865 * WoWLAN capabilities supported by cards. 1866 * 1867 * @version: version of WoWLAN data structure, to ensure backward 1868 * compatibility for firmwares with limited WoWLAN support 1869 * @len: Total length of WoWLAN data 1870 * @data: supported WoWLAN features 1871 */ 1872 struct qlink_wowlan_capab_data { 1873 __le16 version; 1874 __le16 len; 1875 u8 data[]; 1876 } __packed; 1877 1878 /** 1879 * struct qlink_wowlan_support - supported WoWLAN capabilities 1880 * 1881 * @n_patterns: number of supported wakeup patterns 1882 * @pattern_max_len: maximum length of each pattern 1883 * @pattern_min_len: minimum length of each pattern 1884 */ 1885 struct qlink_wowlan_support { 1886 __le32 n_patterns; 1887 __le32 pattern_max_len; 1888 __le32 pattern_min_len; 1889 } __packed; 1890 1891 #endif /* _QTN_QLINK_H_ */ 1892