]> asedeno.scripts.mit.edu Git - linux.git/blob - drivers/net/wireless/intel/iwlwifi/fw/file.h
423cc0cf8e78139146664fd19d30d2a37f8e635b
[linux.git] / drivers / net / wireless / intel / iwlwifi / fw / file.h
1 /******************************************************************************
2  *
3  * This file is provided under a dual BSD/GPLv2 license.  When using or
4  * redistributing this file, you may do so under either license.
5  *
6  * GPL LICENSE SUMMARY
7  *
8  * Copyright(c) 2008 - 2014 Intel Corporation. All rights reserved.
9  * Copyright(c) 2013 - 2015 Intel Mobile Communications GmbH
10  * Copyright(c) 2016 - 2017 Intel Deutschland GmbH
11  * Copyright(c) 2018 Intel Corporation
12  * Copyright(c) 2019 Intel Corporation
13  *
14  * This program is free software; you can redistribute it and/or modify
15  * it under the terms of version 2 of the GNU General Public License as
16  * published by the Free Software Foundation.
17  *
18  * This program is distributed in the hope that it will be useful, but
19  * WITHOUT ANY WARRANTY; without even the implied warranty of
20  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
21  * General Public License for more details.
22  *
23  * The full GNU General Public License is included in this distribution
24  * in the file called COPYING.
25  *
26  * Contact Information:
27  *  Intel Linux Wireless <linuxwifi@intel.com>
28  * Intel Corporation, 5200 N.E. Elam Young Parkway, Hillsboro, OR 97124-6497
29  *
30  * BSD LICENSE
31  *
32  * Copyright(c) 2005 - 2014 Intel Corporation. All rights reserved.
33  * Copyright(c) 2013 - 2015 Intel Mobile Communications GmbH
34  * Copyright(c) 2016 - 2017 Intel Deutschland GmbH
35  * Copyright(c) 2018 Intel Corporation
36  * Copyright(c) 2019 Intel Corporation
37  * All rights reserved.
38  *
39  * Redistribution and use in source and binary forms, with or without
40  * modification, are permitted provided that the following conditions
41  * are met:
42  *
43  *  * Redistributions of source code must retain the above copyright
44  *    notice, this list of conditions and the following disclaimer.
45  *  * Redistributions in binary form must reproduce the above copyright
46  *    notice, this list of conditions and the following disclaimer in
47  *    the documentation and/or other materials provided with the
48  *    distribution.
49  *  * Neither the name Intel Corporation nor the names of its
50  *    contributors may be used to endorse or promote products derived
51  *    from this software without specific prior written permission.
52  *
53  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
54  * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
55  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
56  * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
57  * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
58  * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
59  * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
60  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
61  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
62  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
63  * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
64  *****************************************************************************/
65
66 #ifndef __iwl_fw_file_h__
67 #define __iwl_fw_file_h__
68
69 #include <linux/netdevice.h>
70 #include <linux/nl80211.h>
71
72 /* v1/v2 uCode file layout */
73 struct iwl_ucode_header {
74         __le32 ver;     /* major/minor/API/serial */
75         union {
76                 struct {
77                         __le32 inst_size;       /* bytes of runtime code */
78                         __le32 data_size;       /* bytes of runtime data */
79                         __le32 init_size;       /* bytes of init code */
80                         __le32 init_data_size;  /* bytes of init data */
81                         __le32 boot_size;       /* bytes of bootstrap code */
82                         u8 data[0];             /* in same order as sizes */
83                 } v1;
84                 struct {
85                         __le32 build;           /* build number */
86                         __le32 inst_size;       /* bytes of runtime code */
87                         __le32 data_size;       /* bytes of runtime data */
88                         __le32 init_size;       /* bytes of init code */
89                         __le32 init_data_size;  /* bytes of init data */
90                         __le32 boot_size;       /* bytes of bootstrap code */
91                         u8 data[0];             /* in same order as sizes */
92                 } v2;
93         } u;
94 };
95
96 #define IWL_UCODE_INI_TLV_GROUP 0x1000000
97
98 /*
99  * new TLV uCode file layout
100  *
101  * The new TLV file format contains TLVs, that each specify
102  * some piece of data.
103  */
104
105 enum iwl_ucode_tlv_type {
106         IWL_UCODE_TLV_INVALID           = 0, /* unused */
107         IWL_UCODE_TLV_INST              = 1,
108         IWL_UCODE_TLV_DATA              = 2,
109         IWL_UCODE_TLV_INIT              = 3,
110         IWL_UCODE_TLV_INIT_DATA         = 4,
111         IWL_UCODE_TLV_BOOT              = 5,
112         IWL_UCODE_TLV_PROBE_MAX_LEN     = 6, /* a u32 value */
113         IWL_UCODE_TLV_PAN               = 7,
114         IWL_UCODE_TLV_RUNT_EVTLOG_PTR   = 8,
115         IWL_UCODE_TLV_RUNT_EVTLOG_SIZE  = 9,
116         IWL_UCODE_TLV_RUNT_ERRLOG_PTR   = 10,
117         IWL_UCODE_TLV_INIT_EVTLOG_PTR   = 11,
118         IWL_UCODE_TLV_INIT_EVTLOG_SIZE  = 12,
119         IWL_UCODE_TLV_INIT_ERRLOG_PTR   = 13,
120         IWL_UCODE_TLV_ENHANCE_SENS_TBL  = 14,
121         IWL_UCODE_TLV_PHY_CALIBRATION_SIZE = 15,
122         IWL_UCODE_TLV_WOWLAN_INST       = 16,
123         IWL_UCODE_TLV_WOWLAN_DATA       = 17,
124         IWL_UCODE_TLV_FLAGS             = 18,
125         IWL_UCODE_TLV_SEC_RT            = 19,
126         IWL_UCODE_TLV_SEC_INIT          = 20,
127         IWL_UCODE_TLV_SEC_WOWLAN        = 21,
128         IWL_UCODE_TLV_DEF_CALIB         = 22,
129         IWL_UCODE_TLV_PHY_SKU           = 23,
130         IWL_UCODE_TLV_SECURE_SEC_RT     = 24,
131         IWL_UCODE_TLV_SECURE_SEC_INIT   = 25,
132         IWL_UCODE_TLV_SECURE_SEC_WOWLAN = 26,
133         IWL_UCODE_TLV_NUM_OF_CPU        = 27,
134         IWL_UCODE_TLV_CSCHEME           = 28,
135         IWL_UCODE_TLV_API_CHANGES_SET   = 29,
136         IWL_UCODE_TLV_ENABLED_CAPABILITIES      = 30,
137         IWL_UCODE_TLV_N_SCAN_CHANNELS           = 31,
138         IWL_UCODE_TLV_PAGING            = 32,
139         IWL_UCODE_TLV_SEC_RT_USNIFFER   = 34,
140         /* 35 is unused */
141         IWL_UCODE_TLV_FW_VERSION        = 36,
142         IWL_UCODE_TLV_FW_DBG_DEST       = 38,
143         IWL_UCODE_TLV_FW_DBG_CONF       = 39,
144         IWL_UCODE_TLV_FW_DBG_TRIGGER    = 40,
145         IWL_UCODE_TLV_CMD_VERSIONS      = 48,
146         IWL_UCODE_TLV_FW_GSCAN_CAPA     = 50,
147         IWL_UCODE_TLV_FW_MEM_SEG        = 51,
148         IWL_UCODE_TLV_IML               = 52,
149         IWL_UCODE_TLV_UMAC_DEBUG_ADDRS  = 54,
150         IWL_UCODE_TLV_LMAC_DEBUG_ADDRS  = 55,
151         IWL_UCODE_TLV_FW_RECOVERY_INFO  = 57,
152         IWL_UCODE_TLV_FW_FSEQ_VERSION   = 60,
153
154         IWL_UCODE_TLV_DEBUG_BASE                = IWL_UCODE_INI_TLV_GROUP,
155         IWL_UCODE_TLV_TYPE_DEBUG_INFO           = IWL_UCODE_TLV_DEBUG_BASE + 0,
156         IWL_UCODE_TLV_TYPE_BUFFER_ALLOCATION    = IWL_UCODE_TLV_DEBUG_BASE + 1,
157         IWL_UCODE_TLV_TYPE_HCMD                 = IWL_UCODE_TLV_DEBUG_BASE + 2,
158         IWL_UCODE_TLV_TYPE_REGIONS              = IWL_UCODE_TLV_DEBUG_BASE + 3,
159         IWL_UCODE_TLV_TYPE_TRIGGERS             = IWL_UCODE_TLV_DEBUG_BASE + 4,
160         IWL_UCODE_TLV_DEBUG_MAX = IWL_UCODE_TLV_TYPE_TRIGGERS,
161
162         /* TLVs 0x1000-0x2000 are for internal driver usage */
163         IWL_UCODE_TLV_FW_DBG_DUMP_LST   = 0x1000,
164 };
165
166 struct iwl_ucode_tlv {
167         __le32 type;            /* see above */
168         __le32 length;          /* not including type/length fields */
169         u8 data[0];
170 };
171
172 #define IWL_TLV_UCODE_MAGIC             0x0a4c5749
173 #define FW_VER_HUMAN_READABLE_SZ        64
174
175 struct iwl_tlv_ucode_header {
176         /*
177          * The TLV style ucode header is distinguished from
178          * the v1/v2 style header by first four bytes being
179          * zero, as such is an invalid combination of
180          * major/minor/API/serial versions.
181          */
182         __le32 zero;
183         __le32 magic;
184         u8 human_readable[FW_VER_HUMAN_READABLE_SZ];
185         /* major/minor/API/serial or major in new format */
186         __le32 ver;
187         __le32 build;
188         __le64 ignore;
189         /*
190          * The data contained herein has a TLV layout,
191          * see above for the TLV header and types.
192          * Note that each TLV is padded to a length
193          * that is a multiple of 4 for alignment.
194          */
195         u8 data[0];
196 };
197
198 /*
199  * ucode TLVs
200  *
201  * ability to get extension for: flags & capabilities from ucode binaries files
202  */
203 struct iwl_ucode_api {
204         __le32 api_index;
205         __le32 api_flags;
206 } __packed;
207
208 struct iwl_ucode_capa {
209         __le32 api_index;
210         __le32 api_capa;
211 } __packed;
212
213 /**
214  * enum iwl_ucode_tlv_flag - ucode API flags
215  * @IWL_UCODE_TLV_FLAGS_PAN: This is PAN capable microcode; this previously
216  *      was a separate TLV but moved here to save space.
217  * @IWL_UCODE_TLV_FLAGS_NEWSCAN: new uCode scan behavior on hidden SSID,
218  *      treats good CRC threshold as a boolean
219  * @IWL_UCODE_TLV_FLAGS_MFP: This uCode image supports MFP (802.11w).
220  * @IWL_UCODE_TLV_FLAGS_UAPSD_SUPPORT: This uCode image supports uAPSD
221  * @IWL_UCODE_TLV_FLAGS_SHORT_BL: 16 entries of black list instead of 64 in scan
222  *      offload profile config command.
223  * @IWL_UCODE_TLV_FLAGS_D3_6_IPV6_ADDRS: D3 image supports up to six
224  *      (rather than two) IPv6 addresses
225  * @IWL_UCODE_TLV_FLAGS_NO_BASIC_SSID: not sending a probe with the SSID element
226  *      from the probe request template.
227  * @IWL_UCODE_TLV_FLAGS_NEW_NSOFFL_SMALL: new NS offload (small version)
228  * @IWL_UCODE_TLV_FLAGS_NEW_NSOFFL_LARGE: new NS offload (large version)
229  * @IWL_UCODE_TLV_FLAGS_UAPSD_SUPPORT: General support for uAPSD
230  * @IWL_UCODE_TLV_FLAGS_P2P_PS_UAPSD: P2P client supports uAPSD power save
231  * @IWL_UCODE_TLV_FLAGS_BCAST_FILTERING: uCode supports broadcast filtering.
232  * @IWL_UCODE_TLV_FLAGS_EBS_SUPPORT: this uCode image supports EBS.
233  */
234 enum iwl_ucode_tlv_flag {
235         IWL_UCODE_TLV_FLAGS_PAN                 = BIT(0),
236         IWL_UCODE_TLV_FLAGS_NEWSCAN             = BIT(1),
237         IWL_UCODE_TLV_FLAGS_MFP                 = BIT(2),
238         IWL_UCODE_TLV_FLAGS_SHORT_BL            = BIT(7),
239         IWL_UCODE_TLV_FLAGS_D3_6_IPV6_ADDRS     = BIT(10),
240         IWL_UCODE_TLV_FLAGS_NO_BASIC_SSID       = BIT(12),
241         IWL_UCODE_TLV_FLAGS_NEW_NSOFFL_SMALL    = BIT(15),
242         IWL_UCODE_TLV_FLAGS_NEW_NSOFFL_LARGE    = BIT(16),
243         IWL_UCODE_TLV_FLAGS_UAPSD_SUPPORT       = BIT(24),
244         IWL_UCODE_TLV_FLAGS_EBS_SUPPORT         = BIT(25),
245         IWL_UCODE_TLV_FLAGS_P2P_PS_UAPSD        = BIT(26),
246         IWL_UCODE_TLV_FLAGS_BCAST_FILTERING     = BIT(29),
247 };
248
249 typedef unsigned int __bitwise iwl_ucode_tlv_api_t;
250
251 /**
252  * enum iwl_ucode_tlv_api - ucode api
253  * @IWL_UCODE_TLV_API_FRAGMENTED_SCAN: This ucode supports active dwell time
254  *      longer than the passive one, which is essential for fragmented scan.
255  * @IWL_UCODE_TLV_API_WIFI_MCC_UPDATE: ucode supports MCC updates with source.
256  * @IWL_UCODE_TLV_API_LQ_SS_PARAMS: Configure STBC/BFER via LQ CMD ss_params
257  * @IWL_UCODE_TLV_API_NEW_VERSION: new versioning format
258  * @IWL_UCODE_TLV_API_SCAN_TSF_REPORT: Scan start time reported in scan
259  *      iteration complete notification, and the timestamp reported for RX
260  *      received during scan, are reported in TSF of the mac specified in the
261  *      scan request.
262  * @IWL_UCODE_TLV_API_TKIP_MIC_KEYS: This ucode supports version 2 of
263  *      ADD_MODIFY_STA_KEY_API_S_VER_2.
264  * @IWL_UCODE_TLV_API_STA_TYPE: This ucode supports station type assignement.
265  * @IWL_UCODE_TLV_API_NAN2_VER2: This ucode supports NAN API version 2
266  * @IWL_UCODE_TLV_API_NEW_RX_STATS: should new RX STATISTICS API be used
267  * @IWL_UCODE_TLV_API_QUOTA_LOW_LATENCY: Quota command includes a field
268  *      indicating low latency direction.
269  * @IWL_UCODE_TLV_API_DEPRECATE_TTAK: RX status flag TTAK ok (bit 7) is
270  *      deprecated.
271  * @IWL_UCODE_TLV_API_ADAPTIVE_DWELL_V2: This ucode supports version 8
272  *      of scan request: SCAN_REQUEST_CMD_UMAC_API_S_VER_8
273  * @IWL_UCODE_TLV_API_FRAG_EBS: This ucode supports fragmented EBS
274  * @IWL_UCODE_TLV_API_REDUCE_TX_POWER: This ucode supports v5 of
275  *      the REDUCE_TX_POWER_CMD.
276  * @IWL_UCODE_TLV_API_SHORT_BEACON_NOTIF: This ucode supports the short
277  *      version of the beacon notification.
278  * @IWL_UCODE_TLV_API_BEACON_FILTER_V4: This ucode supports v4 of
279  *      BEACON_FILTER_CONFIG_API_S_VER_4.
280  * @IWL_UCODE_TLV_API_REGULATORY_NVM_INFO: This ucode supports v4 of
281  *      REGULATORY_NVM_GET_INFO_RSP_API_S.
282  * @IWL_UCODE_TLV_API_FTM_NEW_RANGE_REQ: This ucode supports v7 of
283  *      LOCATION_RANGE_REQ_CMD_API_S and v6 of LOCATION_RANGE_RESP_NTFY_API_S.
284  * @IWL_UCODE_TLV_API_SCAN_OFFLOAD_CHANS: This ucode supports v2 of
285  *      SCAN_OFFLOAD_PROFILE_MATCH_RESULTS_S and v3 of
286  *      SCAN_OFFLOAD_PROFILES_QUERY_RSP_S.
287  * @IWL_UCODE_TLV_API_MBSSID_HE: This ucode supports v2 of
288  *      STA_CONTEXT_DOT11AX_API_S
289  * @IWL_UCODE_TLV_CAPA_SAR_TABLE_VER: This ucode supports different sar
290  *      version tables.
291  *
292  * @NUM_IWL_UCODE_TLV_API: number of bits used
293  */
294 enum iwl_ucode_tlv_api {
295         /* API Set 0 */
296         IWL_UCODE_TLV_API_FRAGMENTED_SCAN       = (__force iwl_ucode_tlv_api_t)8,
297         IWL_UCODE_TLV_API_WIFI_MCC_UPDATE       = (__force iwl_ucode_tlv_api_t)9,
298         IWL_UCODE_TLV_API_LQ_SS_PARAMS          = (__force iwl_ucode_tlv_api_t)18,
299         IWL_UCODE_TLV_API_NEW_VERSION           = (__force iwl_ucode_tlv_api_t)20,
300         IWL_UCODE_TLV_API_SCAN_TSF_REPORT       = (__force iwl_ucode_tlv_api_t)28,
301         IWL_UCODE_TLV_API_TKIP_MIC_KEYS         = (__force iwl_ucode_tlv_api_t)29,
302         IWL_UCODE_TLV_API_STA_TYPE              = (__force iwl_ucode_tlv_api_t)30,
303         IWL_UCODE_TLV_API_NAN2_VER2             = (__force iwl_ucode_tlv_api_t)31,
304         /* API Set 1 */
305         IWL_UCODE_TLV_API_ADAPTIVE_DWELL        = (__force iwl_ucode_tlv_api_t)32,
306         IWL_UCODE_TLV_API_OCE                   = (__force iwl_ucode_tlv_api_t)33,
307         IWL_UCODE_TLV_API_NEW_BEACON_TEMPLATE   = (__force iwl_ucode_tlv_api_t)34,
308         IWL_UCODE_TLV_API_NEW_RX_STATS          = (__force iwl_ucode_tlv_api_t)35,
309         IWL_UCODE_TLV_API_WOWLAN_KEY_MATERIAL   = (__force iwl_ucode_tlv_api_t)36,
310         IWL_UCODE_TLV_API_QUOTA_LOW_LATENCY     = (__force iwl_ucode_tlv_api_t)38,
311         IWL_UCODE_TLV_API_DEPRECATE_TTAK        = (__force iwl_ucode_tlv_api_t)41,
312         IWL_UCODE_TLV_API_ADAPTIVE_DWELL_V2     = (__force iwl_ucode_tlv_api_t)42,
313         IWL_UCODE_TLV_API_FRAG_EBS              = (__force iwl_ucode_tlv_api_t)44,
314         IWL_UCODE_TLV_API_REDUCE_TX_POWER       = (__force iwl_ucode_tlv_api_t)45,
315         IWL_UCODE_TLV_API_SHORT_BEACON_NOTIF    = (__force iwl_ucode_tlv_api_t)46,
316         IWL_UCODE_TLV_API_BEACON_FILTER_V4      = (__force iwl_ucode_tlv_api_t)47,
317         IWL_UCODE_TLV_API_REGULATORY_NVM_INFO   = (__force iwl_ucode_tlv_api_t)48,
318         IWL_UCODE_TLV_API_FTM_NEW_RANGE_REQ     = (__force iwl_ucode_tlv_api_t)49,
319         IWL_UCODE_TLV_API_SCAN_OFFLOAD_CHANS    = (__force iwl_ucode_tlv_api_t)50,
320         IWL_UCODE_TLV_API_MBSSID_HE             = (__force iwl_ucode_tlv_api_t)52,
321         IWL_UCODE_TLV_API_WOWLAN_TCP_SYN_WAKE   = (__force iwl_ucode_tlv_api_t)53,
322         IWL_UCODE_TLV_API_FTM_RTT_ACCURACY      = (__force iwl_ucode_tlv_api_t)54,
323         IWL_UCODE_TLV_API_SAR_TABLE_VER         = (__force iwl_ucode_tlv_api_t)55,
324         IWL_UCODE_TLV_API_ADWELL_HB_DEF_N_AP    = (__force iwl_ucode_tlv_api_t)57,
325         IWL_UCODE_TLV_API_SCAN_EXT_CHAN_VER     = (__force iwl_ucode_tlv_api_t)58,
326
327         NUM_IWL_UCODE_TLV_API
328 #ifdef __CHECKER__
329                 /* sparse says it cannot increment the previous enum member */
330                 = 128
331 #endif
332 };
333
334 typedef unsigned int __bitwise iwl_ucode_tlv_capa_t;
335
336 /**
337  * enum iwl_ucode_tlv_capa - ucode capabilities
338  * @IWL_UCODE_TLV_CAPA_D0I3_SUPPORT: supports D0i3
339  * @IWL_UCODE_TLV_CAPA_LAR_SUPPORT: supports Location Aware Regulatory
340  * @IWL_UCODE_TLV_CAPA_UMAC_SCAN: supports UMAC scan.
341  * @IWL_UCODE_TLV_CAPA_BEAMFORMER: supports Beamformer
342  * @IWL_UCODE_TLV_CAPA_TDLS_SUPPORT: support basic TDLS functionality
343  * @IWL_UCODE_TLV_CAPA_TXPOWER_INSERTION_SUPPORT: supports insertion of current
344  *      tx power value into TPC Report action frame and Link Measurement Report
345  *      action frame
346  * @IWL_UCODE_TLV_CAPA_DS_PARAM_SET_IE_SUPPORT: supports updating current
347  *      channel in DS parameter set element in probe requests.
348  * @IWL_UCODE_TLV_CAPA_WFA_TPC_REP_IE_SUPPORT: supports adding TPC Report IE in
349  *      probe requests.
350  * @IWL_UCODE_TLV_CAPA_QUIET_PERIOD_SUPPORT: supports Quiet Period requests
351  * @IWL_UCODE_TLV_CAPA_DQA_SUPPORT: supports dynamic queue allocation (DQA),
352  *      which also implies support for the scheduler configuration command
353  * @IWL_UCODE_TLV_CAPA_TDLS_CHANNEL_SWITCH: supports TDLS channel switching
354  * @IWL_UCODE_TLV_CAPA_CNSLDTD_D3_D0_IMG: Consolidated D3-D0 image
355  * @IWL_UCODE_TLV_CAPA_HOTSPOT_SUPPORT: supports Hot Spot Command
356  * @IWL_UCODE_TLV_CAPA_DC2DC_SUPPORT: supports DC2DC Command
357  * @IWL_UCODE_TLV_CAPA_CSUM_SUPPORT: supports TCP Checksum Offload
358  * @IWL_UCODE_TLV_CAPA_RADIO_BEACON_STATS: support radio and beacon statistics
359  * @IWL_UCODE_TLV_CAPA_P2P_SCM_UAPSD: supports U-APSD on p2p interface when it
360  *      is standalone or with a BSS station interface in the same binding.
361  * @IWL_UCODE_TLV_CAPA_BT_COEX_PLCR: enabled BT Coex packet level co-running
362  * @IWL_UCODE_TLV_CAPA_LAR_MULTI_MCC: ucode supports LAR updates with different
363  *      sources for the MCC. This TLV bit is a future replacement to
364  *      IWL_UCODE_TLV_API_WIFI_MCC_UPDATE. When either is set, multi-source LAR
365  *      is supported.
366  * @IWL_UCODE_TLV_CAPA_BT_COEX_RRC: supports BT Coex RRC
367  * @IWL_UCODE_TLV_CAPA_GSCAN_SUPPORT: supports gscan (no longer used)
368  * @IWL_UCODE_TLV_CAPA_STA_PM_NOTIF: firmware will send STA PM notification
369  * @IWL_UCODE_TLV_CAPA_TLC_OFFLOAD: firmware implements rate scaling algorithm
370  * @IWL_UCODE_TLV_CAPA_DYNAMIC_QUOTA: firmware implements quota related
371  * @IWL_UCODE_TLV_CAPA_COEX_SCHEMA_2: firmware implements Coex Schema 2
372  * IWL_UCODE_TLV_CAPA_CHANNEL_SWITCH_CMD: firmware supports CSA command
373  * @IWL_UCODE_TLV_CAPA_ULTRA_HB_CHANNELS: firmware supports ultra high band
374  *      (6 GHz).
375  * @IWL_UCODE_TLV_CAPA_CS_MODIFY: firmware supports modify action CSA command
376  * @IWL_UCODE_TLV_CAPA_EXTENDED_DTS_MEASURE: extended DTS measurement
377  * @IWL_UCODE_TLV_CAPA_SHORT_PM_TIMEOUTS: supports short PM timeouts
378  * @IWL_UCODE_TLV_CAPA_BT_MPLUT_SUPPORT: supports bt-coex Multi-priority LUT
379  * @IWL_UCODE_TLV_CAPA_CSA_AND_TBTT_OFFLOAD: the firmware supports CSA
380  *      countdown offloading. Beacon notifications are not sent to the host.
381  *      The fw also offloads TBTT alignment.
382  * @IWL_UCODE_TLV_CAPA_BEACON_ANT_SELECTION: firmware will decide on what
383  *      antenna the beacon should be transmitted
384  * @IWL_UCODE_TLV_CAPA_BEACON_STORING: firmware will store the latest beacon
385  *      from AP and will send it upon d0i3 exit.
386  * @IWL_UCODE_TLV_CAPA_LAR_SUPPORT_V3: support LAR API V3
387  * @IWL_UCODE_TLV_CAPA_CT_KILL_BY_FW: firmware responsible for CT-kill
388  * @IWL_UCODE_TLV_CAPA_TEMP_THS_REPORT_SUPPORT: supports temperature
389  *      thresholds reporting
390  * @IWL_UCODE_TLV_CAPA_CTDP_SUPPORT: supports cTDP command
391  * @IWL_UCODE_TLV_CAPA_USNIFFER_UNIFIED: supports usniffer enabled in
392  *      regular image.
393  * @IWL_UCODE_TLV_CAPA_EXTEND_SHARED_MEM_CFG: support getting more shared
394  *      memory addresses from the firmware.
395  * @IWL_UCODE_TLV_CAPA_LQM_SUPPORT: supports Link Quality Measurement
396  * @IWL_UCODE_TLV_CAPA_TX_POWER_ACK: reduced TX power API has larger
397  *      command size (command version 4) that supports toggling ACK TX
398  *      power reduction.
399  * @IWL_UCODE_TLV_CAPA_D3_DEBUG: supports debug recording during D3
400  * @IWL_UCODE_TLV_CAPA_MCC_UPDATE_11AX_SUPPORT: MCC response support 11ax
401  *      capability.
402  * @IWL_UCODE_TLV_CAPA_CSI_REPORTING: firmware is capable of being configured
403  *      to report the CSI information with (certain) RX frames
404  * @IWL_UCODE_TLV_CAPA_FTM_CALIBRATED: has FTM calibrated and thus supports both
405  *      initiator and responder
406  *
407  * @IWL_UCODE_TLV_CAPA_MLME_OFFLOAD: supports MLME offload
408  *
409  * @NUM_IWL_UCODE_TLV_CAPA: number of bits used
410  */
411 enum iwl_ucode_tlv_capa {
412         /* set 0 */
413         IWL_UCODE_TLV_CAPA_D0I3_SUPPORT                 = (__force iwl_ucode_tlv_capa_t)0,
414         IWL_UCODE_TLV_CAPA_LAR_SUPPORT                  = (__force iwl_ucode_tlv_capa_t)1,
415         IWL_UCODE_TLV_CAPA_UMAC_SCAN                    = (__force iwl_ucode_tlv_capa_t)2,
416         IWL_UCODE_TLV_CAPA_BEAMFORMER                   = (__force iwl_ucode_tlv_capa_t)3,
417         IWL_UCODE_TLV_CAPA_TDLS_SUPPORT                 = (__force iwl_ucode_tlv_capa_t)6,
418         IWL_UCODE_TLV_CAPA_TXPOWER_INSERTION_SUPPORT    = (__force iwl_ucode_tlv_capa_t)8,
419         IWL_UCODE_TLV_CAPA_DS_PARAM_SET_IE_SUPPORT      = (__force iwl_ucode_tlv_capa_t)9,
420         IWL_UCODE_TLV_CAPA_WFA_TPC_REP_IE_SUPPORT       = (__force iwl_ucode_tlv_capa_t)10,
421         IWL_UCODE_TLV_CAPA_QUIET_PERIOD_SUPPORT         = (__force iwl_ucode_tlv_capa_t)11,
422         IWL_UCODE_TLV_CAPA_DQA_SUPPORT                  = (__force iwl_ucode_tlv_capa_t)12,
423         IWL_UCODE_TLV_CAPA_TDLS_CHANNEL_SWITCH          = (__force iwl_ucode_tlv_capa_t)13,
424         IWL_UCODE_TLV_CAPA_CNSLDTD_D3_D0_IMG            = (__force iwl_ucode_tlv_capa_t)17,
425         IWL_UCODE_TLV_CAPA_HOTSPOT_SUPPORT              = (__force iwl_ucode_tlv_capa_t)18,
426         IWL_UCODE_TLV_CAPA_DC2DC_CONFIG_SUPPORT         = (__force iwl_ucode_tlv_capa_t)19,
427         IWL_UCODE_TLV_CAPA_CSUM_SUPPORT                 = (__force iwl_ucode_tlv_capa_t)21,
428         IWL_UCODE_TLV_CAPA_RADIO_BEACON_STATS           = (__force iwl_ucode_tlv_capa_t)22,
429         IWL_UCODE_TLV_CAPA_P2P_SCM_UAPSD                = (__force iwl_ucode_tlv_capa_t)26,
430         IWL_UCODE_TLV_CAPA_BT_COEX_PLCR                 = (__force iwl_ucode_tlv_capa_t)28,
431         IWL_UCODE_TLV_CAPA_LAR_MULTI_MCC                = (__force iwl_ucode_tlv_capa_t)29,
432         IWL_UCODE_TLV_CAPA_BT_COEX_RRC                  = (__force iwl_ucode_tlv_capa_t)30,
433         IWL_UCODE_TLV_CAPA_GSCAN_SUPPORT                = (__force iwl_ucode_tlv_capa_t)31,
434
435         /* set 1 */
436         IWL_UCODE_TLV_CAPA_STA_PM_NOTIF                 = (__force iwl_ucode_tlv_capa_t)38,
437         IWL_UCODE_TLV_CAPA_BINDING_CDB_SUPPORT          = (__force iwl_ucode_tlv_capa_t)39,
438         IWL_UCODE_TLV_CAPA_CDB_SUPPORT                  = (__force iwl_ucode_tlv_capa_t)40,
439         IWL_UCODE_TLV_CAPA_D0I3_END_FIRST               = (__force iwl_ucode_tlv_capa_t)41,
440         IWL_UCODE_TLV_CAPA_TLC_OFFLOAD                  = (__force iwl_ucode_tlv_capa_t)43,
441         IWL_UCODE_TLV_CAPA_DYNAMIC_QUOTA                = (__force iwl_ucode_tlv_capa_t)44,
442         IWL_UCODE_TLV_CAPA_COEX_SCHEMA_2                = (__force iwl_ucode_tlv_capa_t)45,
443         IWL_UCODE_TLV_CAPA_CHANNEL_SWITCH_CMD           = (__force iwl_ucode_tlv_capa_t)46,
444         IWL_UCODE_TLV_CAPA_FTM_CALIBRATED               = (__force iwl_ucode_tlv_capa_t)47,
445         IWL_UCODE_TLV_CAPA_ULTRA_HB_CHANNELS            = (__force iwl_ucode_tlv_capa_t)48,
446         IWL_UCODE_TLV_CAPA_CS_MODIFY                    = (__force iwl_ucode_tlv_capa_t)49,
447         IWL_UCODE_TLV_CAPA_SET_LTR_GEN2                 = (__force iwl_ucode_tlv_capa_t)50,
448         IWL_UCODE_TLV_CAPA_SET_PPAG                     = (__force iwl_ucode_tlv_capa_t)52,
449
450         /* set 2 */
451         IWL_UCODE_TLV_CAPA_EXTENDED_DTS_MEASURE         = (__force iwl_ucode_tlv_capa_t)64,
452         IWL_UCODE_TLV_CAPA_SHORT_PM_TIMEOUTS            = (__force iwl_ucode_tlv_capa_t)65,
453         IWL_UCODE_TLV_CAPA_BT_MPLUT_SUPPORT             = (__force iwl_ucode_tlv_capa_t)67,
454         IWL_UCODE_TLV_CAPA_MULTI_QUEUE_RX_SUPPORT       = (__force iwl_ucode_tlv_capa_t)68,
455         IWL_UCODE_TLV_CAPA_CSA_AND_TBTT_OFFLOAD         = (__force iwl_ucode_tlv_capa_t)70,
456         IWL_UCODE_TLV_CAPA_BEACON_ANT_SELECTION         = (__force iwl_ucode_tlv_capa_t)71,
457         IWL_UCODE_TLV_CAPA_BEACON_STORING               = (__force iwl_ucode_tlv_capa_t)72,
458         IWL_UCODE_TLV_CAPA_LAR_SUPPORT_V3               = (__force iwl_ucode_tlv_capa_t)73,
459         IWL_UCODE_TLV_CAPA_CT_KILL_BY_FW                = (__force iwl_ucode_tlv_capa_t)74,
460         IWL_UCODE_TLV_CAPA_TEMP_THS_REPORT_SUPPORT      = (__force iwl_ucode_tlv_capa_t)75,
461         IWL_UCODE_TLV_CAPA_CTDP_SUPPORT                 = (__force iwl_ucode_tlv_capa_t)76,
462         IWL_UCODE_TLV_CAPA_USNIFFER_UNIFIED             = (__force iwl_ucode_tlv_capa_t)77,
463         IWL_UCODE_TLV_CAPA_EXTEND_SHARED_MEM_CFG        = (__force iwl_ucode_tlv_capa_t)80,
464         IWL_UCODE_TLV_CAPA_LQM_SUPPORT                  = (__force iwl_ucode_tlv_capa_t)81,
465         IWL_UCODE_TLV_CAPA_TX_POWER_ACK                 = (__force iwl_ucode_tlv_capa_t)84,
466         IWL_UCODE_TLV_CAPA_D3_DEBUG                     = (__force iwl_ucode_tlv_capa_t)87,
467         IWL_UCODE_TLV_CAPA_LED_CMD_SUPPORT              = (__force iwl_ucode_tlv_capa_t)88,
468         IWL_UCODE_TLV_CAPA_MCC_UPDATE_11AX_SUPPORT      = (__force iwl_ucode_tlv_capa_t)89,
469         IWL_UCODE_TLV_CAPA_CSI_REPORTING                = (__force iwl_ucode_tlv_capa_t)90,
470         IWL_UCODE_TLV_CAPA_DBG_SUSPEND_RESUME_CMD_SUPP  = (__force iwl_ucode_tlv_capa_t)92,
471         IWL_UCODE_TLV_CAPA_DBG_BUF_ALLOC_CMD_SUPP       = (__force iwl_ucode_tlv_capa_t)93,
472
473         /* set 3 */
474         IWL_UCODE_TLV_CAPA_MLME_OFFLOAD                 = (__force iwl_ucode_tlv_capa_t)96,
475
476         NUM_IWL_UCODE_TLV_CAPA
477 #ifdef __CHECKER__
478                 /* sparse says it cannot increment the previous enum member */
479                 = 128
480 #endif
481 };
482
483 /* The default calibrate table size if not specified by firmware file */
484 #define IWL_DEFAULT_STANDARD_PHY_CALIBRATE_TBL_SIZE     18
485 #define IWL_MAX_STANDARD_PHY_CALIBRATE_TBL_SIZE         19
486 #define IWL_MAX_PHY_CALIBRATE_TBL_SIZE                  253
487
488 /* The default max probe length if not specified by the firmware file */
489 #define IWL_DEFAULT_MAX_PROBE_LENGTH    200
490
491 /*
492  * For 16.0 uCode and above, there is no differentiation between sections,
493  * just an offset to the HW address.
494  */
495 #define CPU1_CPU2_SEPARATOR_SECTION     0xFFFFCCCC
496 #define PAGING_SEPARATOR_SECTION        0xAAAABBBB
497
498 /* uCode version contains 4 values: Major/Minor/API/Serial */
499 #define IWL_UCODE_MAJOR(ver)    (((ver) & 0xFF000000) >> 24)
500 #define IWL_UCODE_MINOR(ver)    (((ver) & 0x00FF0000) >> 16)
501 #define IWL_UCODE_API(ver)      (((ver) & 0x0000FF00) >> 8)
502 #define IWL_UCODE_SERIAL(ver)   ((ver) & 0x000000FF)
503
504 /**
505  * struct iwl_tlv_calib_ctrl - Calibration control struct.
506  * Sent as part of the phy configuration command.
507  * @flow_trigger: bitmap for which calibrations to perform according to
508  *              flow triggers.
509  * @event_trigger: bitmap for which calibrations to perform according to
510  *              event triggers.
511  */
512 struct iwl_tlv_calib_ctrl {
513         __le32 flow_trigger;
514         __le32 event_trigger;
515 } __packed;
516
517 enum iwl_fw_phy_cfg {
518         FW_PHY_CFG_RADIO_TYPE_POS = 0,
519         FW_PHY_CFG_RADIO_TYPE = 0x3 << FW_PHY_CFG_RADIO_TYPE_POS,
520         FW_PHY_CFG_RADIO_STEP_POS = 2,
521         FW_PHY_CFG_RADIO_STEP = 0x3 << FW_PHY_CFG_RADIO_STEP_POS,
522         FW_PHY_CFG_RADIO_DASH_POS = 4,
523         FW_PHY_CFG_RADIO_DASH = 0x3 << FW_PHY_CFG_RADIO_DASH_POS,
524         FW_PHY_CFG_TX_CHAIN_POS = 16,
525         FW_PHY_CFG_TX_CHAIN = 0xf << FW_PHY_CFG_TX_CHAIN_POS,
526         FW_PHY_CFG_RX_CHAIN_POS = 20,
527         FW_PHY_CFG_RX_CHAIN = 0xf << FW_PHY_CFG_RX_CHAIN_POS,
528         FW_PHY_CFG_CHAIN_SAD_POS = 23,
529         FW_PHY_CFG_CHAIN_SAD_ENABLED = 0x1 << FW_PHY_CFG_CHAIN_SAD_POS,
530         FW_PHY_CFG_CHAIN_SAD_ANT_A = 0x2 << FW_PHY_CFG_CHAIN_SAD_POS,
531         FW_PHY_CFG_CHAIN_SAD_ANT_B = 0x4 << FW_PHY_CFG_CHAIN_SAD_POS,
532         FW_PHY_CFG_SHARED_CLK = BIT(31),
533 };
534
535 #define IWL_UCODE_MAX_CS                1
536
537 /**
538  * struct iwl_fw_cipher_scheme - a cipher scheme supported by FW.
539  * @cipher: a cipher suite selector
540  * @flags: cipher scheme flags (currently reserved for a future use)
541  * @hdr_len: a size of MPDU security header
542  * @pn_len: a size of PN
543  * @pn_off: an offset of pn from the beginning of the security header
544  * @key_idx_off: an offset of key index byte in the security header
545  * @key_idx_mask: a bit mask of key_idx bits
546  * @key_idx_shift: bit shift needed to get key_idx
547  * @mic_len: mic length in bytes
548  * @hw_cipher: a HW cipher index used in host commands
549  */
550 struct iwl_fw_cipher_scheme {
551         __le32 cipher;
552         u8 flags;
553         u8 hdr_len;
554         u8 pn_len;
555         u8 pn_off;
556         u8 key_idx_off;
557         u8 key_idx_mask;
558         u8 key_idx_shift;
559         u8 mic_len;
560         u8 hw_cipher;
561 } __packed;
562
563 enum iwl_fw_dbg_reg_operator {
564         CSR_ASSIGN,
565         CSR_SETBIT,
566         CSR_CLEARBIT,
567
568         PRPH_ASSIGN,
569         PRPH_SETBIT,
570         PRPH_CLEARBIT,
571
572         INDIRECT_ASSIGN,
573         INDIRECT_SETBIT,
574         INDIRECT_CLEARBIT,
575
576         PRPH_BLOCKBIT,
577 };
578
579 /**
580  * struct iwl_fw_dbg_reg_op - an operation on a register
581  *
582  * @op: &enum iwl_fw_dbg_reg_operator
583  * @addr: offset of the register
584  * @val: value
585  */
586 struct iwl_fw_dbg_reg_op {
587         u8 op;
588         u8 reserved[3];
589         __le32 addr;
590         __le32 val;
591 } __packed;
592
593 /**
594  * enum iwl_fw_dbg_monitor_mode - available monitor recording modes
595  *
596  * @SMEM_MODE: monitor stores the data in SMEM
597  * @EXTERNAL_MODE: monitor stores the data in allocated DRAM
598  * @MARBH_MODE: monitor stores the data in MARBH buffer
599  * @MIPI_MODE: monitor outputs the data through the MIPI interface
600  */
601 enum iwl_fw_dbg_monitor_mode {
602         SMEM_MODE = 0,
603         EXTERNAL_MODE = 1,
604         MARBH_MODE = 2,
605         MIPI_MODE = 3,
606 };
607
608 /**
609  * struct iwl_fw_dbg_mem_seg_tlv - configures the debug data memory segments
610  *
611  * @data_type: the memory segment type to record
612  * @ofs: the memory segment offset
613  * @len: the memory segment length, in bytes
614  *
615  * This parses IWL_UCODE_TLV_FW_MEM_SEG
616  */
617 struct iwl_fw_dbg_mem_seg_tlv {
618         __le32 data_type;
619         __le32 ofs;
620         __le32 len;
621 } __packed;
622
623 /**
624  * struct iwl_fw_dbg_dest_tlv_v1 - configures the destination of the debug data
625  *
626  * @version: version of the TLV - currently 0
627  * @monitor_mode: &enum iwl_fw_dbg_monitor_mode
628  * @size_power: buffer size will be 2^(size_power + 11)
629  * @base_reg: addr of the base addr register (PRPH)
630  * @end_reg:  addr of the end addr register (PRPH)
631  * @write_ptr_reg: the addr of the reg of the write pointer
632  * @wrap_count: the addr of the reg of the wrap_count
633  * @base_shift: shift right of the base addr reg
634  * @end_shift: shift right of the end addr reg
635  * @reg_ops: array of registers operations
636  *
637  * This parses IWL_UCODE_TLV_FW_DBG_DEST
638  */
639 struct iwl_fw_dbg_dest_tlv_v1 {
640         u8 version;
641         u8 monitor_mode;
642         u8 size_power;
643         u8 reserved;
644         __le32 base_reg;
645         __le32 end_reg;
646         __le32 write_ptr_reg;
647         __le32 wrap_count;
648         u8 base_shift;
649         u8 end_shift;
650         struct iwl_fw_dbg_reg_op reg_ops[0];
651 } __packed;
652
653 /* Mask of the register for defining the LDBG MAC2SMEM buffer SMEM size */
654 #define IWL_LDBG_M2S_BUF_SIZE_MSK       0x0fff0000
655 /* Mask of the register for defining the LDBG MAC2SMEM SMEM base address */
656 #define IWL_LDBG_M2S_BUF_BA_MSK         0x00000fff
657 /* The smem buffer chunks are in units of 256 bits */
658 #define IWL_M2S_UNIT_SIZE                       0x100
659
660 struct iwl_fw_dbg_dest_tlv {
661         u8 version;
662         u8 monitor_mode;
663         u8 size_power;
664         u8 reserved;
665         __le32 cfg_reg;
666         __le32 write_ptr_reg;
667         __le32 wrap_count;
668         u8 base_shift;
669         u8 size_shift;
670         struct iwl_fw_dbg_reg_op reg_ops[0];
671 } __packed;
672
673 struct iwl_fw_dbg_conf_hcmd {
674         u8 id;
675         u8 reserved;
676         __le16 len;
677         u8 data[0];
678 } __packed;
679
680 /**
681  * enum iwl_fw_dbg_trigger_mode - triggers functionalities
682  *
683  * @IWL_FW_DBG_TRIGGER_START: when trigger occurs re-conf the dbg mechanism
684  * @IWL_FW_DBG_TRIGGER_STOP: when trigger occurs pull the dbg data
685  * @IWL_FW_DBG_TRIGGER_MONITOR_ONLY: when trigger occurs trigger is set to
686  *      collect only monitor data
687  */
688 enum iwl_fw_dbg_trigger_mode {
689         IWL_FW_DBG_TRIGGER_START = BIT(0),
690         IWL_FW_DBG_TRIGGER_STOP = BIT(1),
691         IWL_FW_DBG_TRIGGER_MONITOR_ONLY = BIT(2),
692 };
693
694 /**
695  * enum iwl_fw_dbg_trigger_flags - the flags supported by wrt triggers
696  * @IWL_FW_DBG_FORCE_RESTART: force a firmware restart
697  */
698 enum iwl_fw_dbg_trigger_flags {
699         IWL_FW_DBG_FORCE_RESTART = BIT(0),
700 };
701
702 /**
703  * enum iwl_fw_dbg_trigger_vif_type - define the VIF type for a trigger
704  * @IWL_FW_DBG_CONF_VIF_ANY: any vif type
705  * @IWL_FW_DBG_CONF_VIF_IBSS: IBSS mode
706  * @IWL_FW_DBG_CONF_VIF_STATION: BSS mode
707  * @IWL_FW_DBG_CONF_VIF_AP: AP mode
708  * @IWL_FW_DBG_CONF_VIF_P2P_CLIENT: P2P Client mode
709  * @IWL_FW_DBG_CONF_VIF_P2P_GO: P2P GO mode
710  * @IWL_FW_DBG_CONF_VIF_P2P_DEVICE: P2P device
711  */
712 enum iwl_fw_dbg_trigger_vif_type {
713         IWL_FW_DBG_CONF_VIF_ANY = NL80211_IFTYPE_UNSPECIFIED,
714         IWL_FW_DBG_CONF_VIF_IBSS = NL80211_IFTYPE_ADHOC,
715         IWL_FW_DBG_CONF_VIF_STATION = NL80211_IFTYPE_STATION,
716         IWL_FW_DBG_CONF_VIF_AP = NL80211_IFTYPE_AP,
717         IWL_FW_DBG_CONF_VIF_P2P_CLIENT = NL80211_IFTYPE_P2P_CLIENT,
718         IWL_FW_DBG_CONF_VIF_P2P_GO = NL80211_IFTYPE_P2P_GO,
719         IWL_FW_DBG_CONF_VIF_P2P_DEVICE = NL80211_IFTYPE_P2P_DEVICE,
720 };
721
722 /**
723  * struct iwl_fw_dbg_trigger_tlv - a TLV that describes the trigger
724  * @id: &enum iwl_fw_dbg_trigger
725  * @vif_type: &enum iwl_fw_dbg_trigger_vif_type
726  * @stop_conf_ids: bitmap of configurations this trigger relates to.
727  *      if the mode is %IWL_FW_DBG_TRIGGER_STOP, then if the bit corresponding
728  *      to the currently running configuration is set, the data should be
729  *      collected.
730  * @stop_delay: how many milliseconds to wait before collecting the data
731  *      after the STOP trigger fires.
732  * @mode: &enum iwl_fw_dbg_trigger_mode - can be stop / start of both
733  * @start_conf_id: if mode is %IWL_FW_DBG_TRIGGER_START, this defines what
734  *      configuration should be applied when the triggers kicks in.
735  * @occurrences: number of occurrences. 0 means the trigger will never fire.
736  * @trig_dis_ms: the time, in milliseconds, after an occurrence of this
737  *      trigger in which another occurrence should be ignored.
738  * @flags: &enum iwl_fw_dbg_trigger_flags
739  */
740 struct iwl_fw_dbg_trigger_tlv {
741         __le32 id;
742         __le32 vif_type;
743         __le32 stop_conf_ids;
744         __le32 stop_delay;
745         u8 mode;
746         u8 start_conf_id;
747         __le16 occurrences;
748         __le16 trig_dis_ms;
749         u8 flags;
750         u8 reserved[5];
751
752         u8 data[0];
753 } __packed;
754
755 #define FW_DBG_START_FROM_ALIVE 0
756 #define FW_DBG_CONF_MAX         32
757 #define FW_DBG_INVALID          0xff
758
759 /**
760  * struct iwl_fw_dbg_trigger_missed_bcon - configures trigger for missed beacons
761  * @stop_consec_missed_bcon: stop recording if threshold is crossed.
762  * @stop_consec_missed_bcon_since_rx: stop recording if threshold is crossed.
763  * @start_consec_missed_bcon: start recording if threshold is crossed.
764  * @start_consec_missed_bcon_since_rx: start recording if threshold is crossed.
765  * @reserved1: reserved
766  * @reserved2: reserved
767  */
768 struct iwl_fw_dbg_trigger_missed_bcon {
769         __le32 stop_consec_missed_bcon;
770         __le32 stop_consec_missed_bcon_since_rx;
771         __le32 reserved2[2];
772         __le32 start_consec_missed_bcon;
773         __le32 start_consec_missed_bcon_since_rx;
774         __le32 reserved1[2];
775 } __packed;
776
777 /**
778  * struct iwl_fw_dbg_trigger_cmd - configures trigger for messages from FW.
779  * cmds: the list of commands to trigger the collection on
780  */
781 struct iwl_fw_dbg_trigger_cmd {
782         struct cmd {
783                 u8 cmd_id;
784                 u8 group_id;
785         } __packed cmds[16];
786 } __packed;
787
788 /**
789  * iwl_fw_dbg_trigger_stats - configures trigger for statistics
790  * @stop_offset: the offset of the value to be monitored
791  * @stop_threshold: the threshold above which to collect
792  * @start_offset: the offset of the value to be monitored
793  * @start_threshold: the threshold above which to start recording
794  */
795 struct iwl_fw_dbg_trigger_stats {
796         __le32 stop_offset;
797         __le32 stop_threshold;
798         __le32 start_offset;
799         __le32 start_threshold;
800 } __packed;
801
802 /**
803  * struct iwl_fw_dbg_trigger_low_rssi - trigger for low beacon RSSI
804  * @rssi: RSSI value to trigger at
805  */
806 struct iwl_fw_dbg_trigger_low_rssi {
807         __le32 rssi;
808 } __packed;
809
810 /**
811  * struct iwl_fw_dbg_trigger_mlme - configures trigger for mlme events
812  * @stop_auth_denied: number of denied authentication to collect
813  * @stop_auth_timeout: number of authentication timeout to collect
814  * @stop_rx_deauth: number of Rx deauth before to collect
815  * @stop_tx_deauth: number of Tx deauth before to collect
816  * @stop_assoc_denied: number of denied association to collect
817  * @stop_assoc_timeout: number of association timeout to collect
818  * @stop_connection_loss: number of connection loss to collect
819  * @start_auth_denied: number of denied authentication to start recording
820  * @start_auth_timeout: number of authentication timeout to start recording
821  * @start_rx_deauth: number of Rx deauth to start recording
822  * @start_tx_deauth: number of Tx deauth to start recording
823  * @start_assoc_denied: number of denied association to start recording
824  * @start_assoc_timeout: number of association timeout to start recording
825  * @start_connection_loss: number of connection loss to start recording
826  */
827 struct iwl_fw_dbg_trigger_mlme {
828         u8 stop_auth_denied;
829         u8 stop_auth_timeout;
830         u8 stop_rx_deauth;
831         u8 stop_tx_deauth;
832
833         u8 stop_assoc_denied;
834         u8 stop_assoc_timeout;
835         u8 stop_connection_loss;
836         u8 reserved;
837
838         u8 start_auth_denied;
839         u8 start_auth_timeout;
840         u8 start_rx_deauth;
841         u8 start_tx_deauth;
842
843         u8 start_assoc_denied;
844         u8 start_assoc_timeout;
845         u8 start_connection_loss;
846         u8 reserved2;
847 } __packed;
848
849 /**
850  * struct iwl_fw_dbg_trigger_txq_timer - configures the Tx queue's timer
851  * @command_queue: timeout for the command queue in ms
852  * @bss: timeout for the queues of a BSS (except for TDLS queues) in ms
853  * @softap: timeout for the queues of a softAP in ms
854  * @p2p_go: timeout for the queues of a P2P GO in ms
855  * @p2p_client: timeout for the queues of a P2P client in ms
856  * @p2p_device: timeout for the queues of a P2P device in ms
857  * @ibss: timeout for the queues of an IBSS in ms
858  * @tdls: timeout for the queues of a TDLS station in ms
859  */
860 struct iwl_fw_dbg_trigger_txq_timer {
861         __le32 command_queue;
862         __le32 bss;
863         __le32 softap;
864         __le32 p2p_go;
865         __le32 p2p_client;
866         __le32 p2p_device;
867         __le32 ibss;
868         __le32 tdls;
869         __le32 reserved[4];
870 } __packed;
871
872 /**
873  * struct iwl_fw_dbg_trigger_time_event - configures a time event trigger
874  * time_Events: a list of tuples <id, action_bitmap>. The driver will issue a
875  *      trigger each time a time event notification that relates to time event
876  *      id with one of the actions in the bitmap is received and
877  *      BIT(notif->status) is set in status_bitmap.
878  *
879  */
880 struct iwl_fw_dbg_trigger_time_event {
881         struct {
882                 __le32 id;
883                 __le32 action_bitmap;
884                 __le32 status_bitmap;
885         } __packed time_events[16];
886 } __packed;
887
888 /**
889  * struct iwl_fw_dbg_trigger_ba - configures BlockAck related trigger
890  * rx_ba_start: tid bitmap to configure on what tid the trigger should occur
891  *      when an Rx BlockAck session is started.
892  * rx_ba_stop: tid bitmap to configure on what tid the trigger should occur
893  *      when an Rx BlockAck session is stopped.
894  * tx_ba_start: tid bitmap to configure on what tid the trigger should occur
895  *      when a Tx BlockAck session is started.
896  * tx_ba_stop: tid bitmap to configure on what tid the trigger should occur
897  *      when a Tx BlockAck session is stopped.
898  * rx_bar: tid bitmap to configure on what tid the trigger should occur
899  *      when a BAR is received (for a Tx BlockAck session).
900  * tx_bar: tid bitmap to configure on what tid the trigger should occur
901  *      when a BAR is send (for an Rx BlocAck session).
902  * frame_timeout: tid bitmap to configure on what tid the trigger should occur
903  *      when a frame times out in the reodering buffer.
904  */
905 struct iwl_fw_dbg_trigger_ba {
906         __le16 rx_ba_start;
907         __le16 rx_ba_stop;
908         __le16 tx_ba_start;
909         __le16 tx_ba_stop;
910         __le16 rx_bar;
911         __le16 tx_bar;
912         __le16 frame_timeout;
913 } __packed;
914
915 /**
916  * struct iwl_fw_dbg_trigger_tdls - configures trigger for TDLS events.
917  * @action_bitmap: the TDLS action to trigger the collection upon
918  * @peer_mode: trigger on specific peer or all
919  * @peer: the TDLS peer to trigger the collection on
920  */
921 struct iwl_fw_dbg_trigger_tdls {
922         u8 action_bitmap;
923         u8 peer_mode;
924         u8 peer[ETH_ALEN];
925         u8 reserved[4];
926 } __packed;
927
928 /**
929  * struct iwl_fw_dbg_trigger_tx_status - configures trigger for tx response
930  *  status.
931  * @statuses: the list of statuses to trigger the collection on
932  */
933 struct iwl_fw_dbg_trigger_tx_status {
934         struct tx_status {
935                 u8 status;
936                 u8 reserved[3];
937         } __packed statuses[16];
938         __le32 reserved[2];
939 } __packed;
940
941 /**
942  * struct iwl_fw_dbg_conf_tlv - a TLV that describes a debug configuration.
943  * @id: conf id
944  * @usniffer: should the uSniffer image be used
945  * @num_of_hcmds: how many HCMDs to send are present here
946  * @hcmd: a variable length host command to be sent to apply the configuration.
947  *      If there is more than one HCMD to send, they will appear one after the
948  *      other and be sent in the order that they appear in.
949  * This parses IWL_UCODE_TLV_FW_DBG_CONF. The user can add up-to
950  * %FW_DBG_CONF_MAX configuration per run.
951  */
952 struct iwl_fw_dbg_conf_tlv {
953         u8 id;
954         u8 usniffer;
955         u8 reserved;
956         u8 num_of_hcmds;
957         struct iwl_fw_dbg_conf_hcmd hcmd;
958 } __packed;
959
960 #define IWL_FW_CMD_VER_UNKNOWN 99
961
962 /**
963  * struct iwl_fw_cmd_version - firmware command version entry
964  * @cmd: command ID
965  * @group: group ID
966  * @cmd_ver: command version
967  * @notif_ver: notification version
968  */
969 struct iwl_fw_cmd_version {
970         u8 cmd;
971         u8 group;
972         u8 cmd_ver;
973         u8 notif_ver;
974 } __packed;
975
976 static inline size_t _iwl_tlv_array_len(const struct iwl_ucode_tlv *tlv,
977                                         size_t fixed_size, size_t var_size)
978 {
979         size_t var_len = le32_to_cpu(tlv->length) - fixed_size;
980
981         if (WARN_ON(var_len % var_size))
982                 return 0;
983
984         return var_len / var_size;
985 }
986
987 #define iwl_tlv_array_len(_tlv_ptr, _struct_ptr, _memb)                 \
988         _iwl_tlv_array_len((_tlv_ptr), sizeof(*(_struct_ptr)),          \
989                            sizeof(_struct_ptr->_memb[0]))
990
991 #endif  /* __iwl_fw_file_h__ */