xref: /wlan-dirver/qca-wifi-host-cmn/qdf/inc/qdf_types.h (revision d0c05845839e5f2ba5a8dcebe0cd3e4cd4e8dfcf)
1 /*
2  * Copyright (c) 2014-2021 The Linux Foundation. All rights reserved.
3  * Copyright (c) 2021-2022 Qualcomm Innovation Center, Inc. All rights reserved.
4  *
5  * Permission to use, copy, modify, and/or distribute this software for
6  * any purpose with or without fee is hereby granted, provided that the
7  * above copyright notice and this permission notice appear in all
8  * copies.
9  *
10  * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL
11  * WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED
12  * WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE
13  * AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL
14  * DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR
15  * PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
16  * TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
17  * PERFORMANCE OF THIS SOFTWARE.
18  */
19 
20 /**
21  * DOC: qdf_types.h
22  * QCA driver framework (QDF) basic type definitions
23  */
24 
25 #if !defined(__QDF_TYPES_H)
26 #define __QDF_TYPES_H
27 
28 #define qdf_must_check __qdf_must_check
29 
30 /* Include Files */
31 #include <i_qdf_types.h>
32 #include <stdarg.h>
33 #ifdef TSOSEG_DEBUG
34 #include <qdf_atomic.h>
35 #endif
36 #include "qdf_status.h"
37 
38 /* Preprocessor definitions and constants */
39 #define QDF_MAX_SGLIST 4
40 
41 #define CPU_CLUSTER_TYPE_LITTLE 0
42 #define CPU_CLUSTER_TYPE_PERF 1
43 
44 /**
45  * struct qdf_sglist - scatter-gather list
46  * @nsegs: total number of segments
47  * struct __sg_segs - scatter-gather segment list
48  * @vaddr: Virtual address of the segment
49  * @len: Length of the segment
50  */
51 typedef struct qdf_sglist {
52 	uint32_t nsegs;
53 	struct __sg_segs {
54 		uint8_t  *vaddr;
55 		uint32_t len;
56 	} sg_segs[QDF_MAX_SGLIST];
57 } qdf_sglist_t;
58 
59 #define QDF_MAX_SCATTER __QDF_MAX_SCATTER
60 #define QDF_NSEC_PER_MSEC __QDF_NSEC_PER_MSEC
61 
62 /**
63  * QDF_SWAP_U16 - swap input u16 value
64  * @_x: variable to swap
65  */
66 #define QDF_SWAP_U16(_x) \
67 	((((_x) << 8) & 0xFF00) | (((_x) >> 8) & 0x00FF))
68 
69 /**
70  * QDF_SWAP_U32 - swap input u32 value
71  * @_x: variable to swap
72  */
73 #define QDF_SWAP_U32(_x) \
74 	(((((_x) << 24) & 0xFF000000) | (((_x) >> 24) & 0x000000FF)) | \
75 	 ((((_x) << 8) & 0x00FF0000) | (((_x) >> 8) & 0x0000FF00)))
76 
77 /* ticks per second */
78 #define QDF_TICKS_PER_SECOND (1000)
79 
80 /**
81  * QDF_ARRAY_SIZE - get array size
82  * @_arr: array variable name
83  */
84 #define QDF_ARRAY_SIZE(_arr) (sizeof(_arr) / sizeof((_arr)[0]))
85 
86 #define QDF_MAX_SCATTER __QDF_MAX_SCATTER
87 
88 /**
89  * qdf_packed - denotes structure is packed.
90  */
91 #define qdf_packed __qdf_packed
92 
93 /**
94  * qdf_toupper - char lower to upper.
95  */
96 #define qdf_toupper __qdf_toupper
97 
98 typedef void *qdf_net_handle_t;
99 
100 typedef void *qdf_netlink_handle_t;
101 typedef void *qdf_drv_handle_t;
102 typedef void *qdf_os_handle_t;
103 typedef void *qdf_pm_t;
104 
105 
106 /**
107  * typedef qdf_handle_t - handles opaque to each other
108  */
109 typedef void *qdf_handle_t;
110 
111 /**
112  * typedef qdf_freq_t - define frequency as a 16 bit/32 bit
113  * unsigned integer depending on the requirement
114  */
115 #ifdef CONFIG_16_BIT_FREQ_TYPE
116 typedef uint16_t qdf_freq_t;
117 #else
118 typedef uint32_t qdf_freq_t;
119 #endif
120 /**
121  * typedef qdf_device_t - Platform/bus generic handle.
122  * Used for bus specific functions.
123  */
124 typedef __qdf_device_t qdf_device_t;
125 
126 /* Byte order identifiers */
127 typedef __qdf_le16_t qdf_le16_t;
128 typedef __qdf_le32_t qdf_le32_t;
129 typedef __qdf_le64_t qdf_le64_t;
130 typedef __qdf_be16_t qdf_be16_t;
131 typedef __qdf_be32_t qdf_be32_t;
132 typedef __qdf_be64_t qdf_be64_t;
133 
134 /**
135  * typedef qdf_size_t - size of an object
136  */
137 typedef __qdf_size_t qdf_size_t;
138 
139 /**
140  * typedef __qdf_off_t - offset for API's that need them.
141  */
142 typedef __qdf_off_t      qdf_off_t;
143 
144 /**
145  * typedef qdf_dma_map_t - DMA mapping object.
146  */
147 typedef __qdf_dma_map_t qdf_dma_map_t;
148 
149 /**
150  * tyepdef qdf_dma_addr_t - DMA address.
151  */
152 typedef __qdf_dma_addr_t qdf_dma_addr_t;
153 
154 /**
155  * typedef __qdf_dma_size_t - DMA size.
156  */
157 typedef __qdf_dma_size_t     qdf_dma_size_t;
158 
159 /**
160  * tyepdef qdf_dma_context_t - DMA context.
161  */
162 typedef __qdf_dma_context_t qdf_dma_context_t;
163 
164 typedef __qdf_mem_info_t qdf_mem_info_t;
165 typedef __sgtable_t sgtable_t;
166 
167 /**
168  * typepdef qdf_cpu_mask - CPU Mask
169  */
170 typedef __qdf_cpu_mask qdf_cpu_mask;
171 
172 /**
173  * pointer to net device
174  */
175 typedef __qdf_netdev_t qdf_netdev_t;
176 
177 /**
178  * pointer to napi struct
179  */
180 typedef __qdf_napi_struct qdf_napi_struct;
181 
182 /**
183  * pointer to net dev stats
184  */
185 typedef __qdf_net_dev_stats qdf_net_dev_stats;
186 
187 /**
188  * struct qdf_dma_map_info - Information inside a DMA map.
189  * @nsegs: total number mapped segments
190  * struct __dma_segs - Information of physical address.
191  * @paddr: physical(dam'able) address of the segment
192  * @len: length of the segment
193  */
194 typedef struct qdf_dma_map_info {
195 	uint32_t nsegs;
196 	struct __dma_segs {
197 		qdf_dma_addr_t paddr;
198 		qdf_dma_size_t len;
199 	} dma_segs[QDF_MAX_SCATTER];
200 } qdf_dmamap_info_t;
201 
202 /**
203  * struct qdf_shared_mem - Shared memory resource
204  * @mem_info: memory info struct
205  * @vaddr: virtual address
206  * @sgtable: scatter-gather table
207  * @memctx: dma address
208  */
209 typedef struct qdf_shared_mem {
210 	qdf_mem_info_t mem_info;
211 	void *vaddr;
212 	sgtable_t sgtable;
213 	qdf_dma_mem_context(memctx);
214 } qdf_shared_mem_t;
215 
216 #define qdf_iomem_t __qdf_iomem_t
217 
218 /**
219  * typedef enum QDF_TIMER_TYPE - QDF timer type
220  * @QDF_TIMER_TYPE_SW: Deferrable SW timer it will not cause CPU to wake up
221  * on expiry
222  * @QDF_TIMER_TYPE_WAKE_APPS: Non deferrable timer which will cause CPU to
223  * wake up on expiry
224  * @QDF_TIMER_TYPE_SW_SPIN: Deferrable&Pinned SW timer, it will not cause cpu
225  * to wake up on expiry and be able to queue on assigned cpu by add_timer_on
226  */
227 typedef enum {
228 	QDF_TIMER_TYPE_SW,
229 	QDF_TIMER_TYPE_WAKE_APPS,
230 	QDF_TIMER_TYPE_SW_SPIN
231 } QDF_TIMER_TYPE;
232 
233 /**
234  * tyepdef qdf_resource_type_t - hw resources
235  * @QDF_RESOURCE_TYPE_MEM: memory resource
236  * @QDF_RESOURCE_TYPE_IO: io resource
237  * Define the hw resources the OS has allocated for the device
238  * Note that start defines a mapped area.
239  */
240 typedef enum {
241 	QDF_RESOURCE_TYPE_MEM,
242 	QDF_RESOURCE_TYPE_IO,
243 } qdf_resource_type_t;
244 
245 /**
246  * tyepdef qdf_resource_t - representation of a h/w resource.
247  * @start: start
248  * @end: end
249  * @type: resource type
250  */
251 typedef struct {
252 	uint64_t start;
253 	uint64_t end;
254 	qdf_resource_type_t type;
255 } qdf_resource_t;
256 
257 /**
258  * typedef qdf_dma_dir_t - DMA directions
259  * @QDF_DMA_BIDIRECTIONAL: bidirectional data
260  * @QDF_DMA_TO_DEVICE: data going from device to memory
261  * @QDF_DMA_FROM_DEVICE: data going from memory to device
262  */
263 typedef enum {
264 	QDF_DMA_BIDIRECTIONAL = __QDF_DMA_BIDIRECTIONAL,
265 	QDF_DMA_TO_DEVICE = __QDF_DMA_TO_DEVICE,
266 	QDF_DMA_FROM_DEVICE = __QDF_DMA_FROM_DEVICE,
267 } qdf_dma_dir_t;
268 
269 /**
270  * enum qdf_driver_type - Indicate the driver type and based on this
271  * do appropriate initialization.
272  *
273  * @QDF_DRIVER_TYPE_PRODUCTION: Driver used in the production
274  * @QDF_DRIVER_TYPE_MFG: Driver used in the Factory
275  * @QDF_DRIVER_TYPE_INVALID: Invalid and unrecognized type
276  *
277  */
278 enum qdf_driver_type {
279 	QDF_DRIVER_TYPE_PRODUCTION = 0,
280 	QDF_DRIVER_TYPE_MFG = 1,
281 	QDF_DRIVER_TYPE_INVALID = 0x7FFFFFFF
282 };
283 
284 /* work queue(kernel thread)/DPC function callback */
285 typedef void (*qdf_defer_fn_t)(void *);
286 
287 /*
288  * Prototype of the critical region function that is to be
289  * executed with spinlock held and interrupt disalbed
290  */
291 typedef bool (*qdf_irqlocked_func_t)(void *);
292 
293 #define qdf_offsetof(type, field) offsetof(type, field)
294 
295 /**
296  * typedef enum QDF_MODULE_ID  - Debug category level
297  * @QDF_MODULE_ID_MIN: The smallest/starting module id
298  * @QDF_MODULE_ID_TDLS: TDLS
299  * @QDF_MODULE_ID_ACS: auto channel selection
300  * @QDF_MODULE_ID_SCAN_SM: scan state machine
301  * @QDF_MODULE_ID_SCANENTRY: scan entry
302  * @QDF_MODULE_ID_WDS: WDS handling
303  * @QDF_MODULE_ID_ACTION: action management frames
304  * @QDF_MODULE_ID_ROAM: sta mode roaming
305  * @QDF_MODULE_ID_INACT: inactivity handling
306  * @QDF_MODULE_ID_DOTH: 11.h
307  * @QDF_MODULE_ID_IQUE: IQUE features
308  * @QDF_MODULE_ID_WME: WME protocol
309  * @QDF_MODULE_ID_ACL: ACL handling
310  * @QDF_MODULE_ID_WPA: WPA/RSN protocol
311  * @QDF_MODULE_ID_RADKEYS: dump 802.1x keys
312  * @QDF_MODULE_ID_RADDUMP: dump 802.1x radius packets
313  * @QDF_MODULE_ID_RADIUS: 802.1x radius client
314  * @QDF_MODULE_ID_DOT1XSM: 802.1x state machine
315  * @QDF_MODULE_ID_DOT1X: 802.1x authenticator
316  * @QDF_MODULE_ID_POWER: power save handling
317  * @QDF_MODULE_ID_STATS: state machine
318  * @QDF_MODULE_ID_OUTPUT: output handling
319  * @QDF_MODULE_ID_SCAN: scanning
320  * @QDF_MODULE_ID_AUTH: authentication handling
321  * @QDF_MODULE_ID_ASSOC: association handling
322  * @QDF_MODULE_ID_NODE: node handling
323  * @QDF_MODULE_ID_ELEMID: element id parsing
324  * @QDF_MODULE_ID_XRATE: rate set handling
325  * @QDF_MODULE_ID_INPUT: input handling
326  * @QDF_MODULE_ID_CRYPTO: crypto work
327  * @QDF_MODULE_ID_DUMPPKTS: IFF_LINK2 equivalant
328  * @QDF_MODULE_ID_DEBUG: IFF_DEBUG equivalent
329  * @QDF_MODULE_ID_MLME: MLME
330  * @QDF_MODULE_ID_RRM: Radio resource measurement
331  * @QDF_MODULE_ID_WNM: Wireless Network Management
332  * @QDF_MODULE_ID_P2P_PROT: P2P Protocol driver
333  * @QDF_MODULE_ID_PROXYARP: 11v Proxy ARP
334  * @QDF_MODULE_ID_L2TIF: Hotspot 2.0 L2 TIF
335  * @QDF_MODULE_ID_WIFIPOS: WifiPositioning Feature
336  * @QDF_MODULE_ID_WRAP: WRAP or Wireless ProxySTA
337  * @QDF_MODULE_ID_DFS: DFS debug mesg
338  * @QDF_MODULE_ID_TLSHIM: TLSHIM module ID
339  * @QDF_MODULE_ID_WMI: WMI module ID
340  * @QDF_MODULE_ID_HTT: HTT module ID
341  * @QDF_MODULE_ID_HDD: HDD module ID
342  * @QDF_MODULE_ID_SME: SME module ID
343  * @QDF_MODULE_ID_PE: PE module ID
344  * @QDF_MODULE_ID_WMA: WMA module ID
345  * @QDF_MODULE_ID_SYS: SYS module ID
346  * @QDF_MODULE_ID_QDF: QDF module ID
347  * @QDF_MODULE_ID_SAP: SAP module ID
348  * @QDF_MODULE_ID_HDD_SOFTAP: HDD SAP module ID
349  * @QDF_MODULE_ID_HDD_DATA: HDD DATA module ID
350  * @QDF_MODULE_ID_HDD_SAP_DATA: HDD SAP DATA module ID
351  * @QDF_MODULE_ID_HIF: HIF module ID
352  * @QDF_MODULE_ID_HTC: HTC module ID
353  * @QDF_MODULE_ID_TXRX: TXRX module ID
354  * @QDF_MODULE_ID_QDF_DEVICE: QDF DEVICE module ID
355  * @QDF_MODULE_ID_CFG: CFG module ID
356  * @QDF_MODULE_ID_BMI: BMI module ID
357  * @QDF_MODULE_ID_EPPING: EPPING module ID
358  * @QDF_MODULE_ID_QVIT: QVIT module ID
359  * @QDF_MODULE_ID_DP: Data-path module ID
360  * @QDF_MODULE_ID_HAL: Hal abstraction module ID
361  * @QDF_MODULE_ID_SOC: SOC module ID
362  * @QDF_MODULE_ID_OS_IF: OS-interface module ID
363  * @QDF_MODULE_ID_TARGET_IF: targer interface module ID
364  * @QDF_MODULE_ID_SCHEDULER: schduler module ID
365  * @QDF_MODULE_ID_MGMT_TXRX: management TX/RX module ID
366  * @QDF_MODULE_ID_SERIALIZATION: serialization module ID
367  * @QDF_MODULE_ID_PMO: PMO (power manager and offloads) Module ID
368  * @QDF_MODULE_ID_P2P: P2P module ID
369  * @QDF_MODULE_ID_POLICY_MGR: Policy Manager module ID
370  * @QDF_MODULE_ID_CONFIG: CFG (configuration) component ID
371  * @QDF_MODULE_ID_REGULATORY: REGULATORY module ID
372  * @QDF_MODULE_ID_NAN: NAN module ID
373  * @QDF_MODULE_ID_SPECTRAL: Spectral module ID
374  * @QDF_MODULE_ID_ROAM_DEBUG: Roam Debug logging
375  * @QDF_MODULE_ID_CDP: Converged Data Path module ID
376  * @QDF_MODULE_ID_DIRECT_BUF_RX: Direct Buffer Receive module ID
377  * @QDF_MODULE_ID_DISA: DISA (encryption test) module ID
378  * @QDF_MODULE_ID_GREEN_AP: Green AP related logging
379  * @QDF_MODULE_ID_FTM: FTM module ID
380  * @QDF_MODULE_ID_FD: FILS discovery logging
381  * @QDF_MODULE_ID_OCB: OCB module ID
382  * @QDF_MODULE_ID_IPA: IPA module ID
383  * @QDF_MODULE_ID_CP_STATS: Control Plane Statistics ID
384  * @QDF_MODULE_ID_ACTION_OUI: ACTION OUI module ID
385  * @QDF_MODULE_ID_TARGET: Target module ID
386  * @QDF_MODULE_ID_MBSSIE: MBSS IE ID
387  * @QDF_MODULE_ID_FWOL: FW Offload module ID
388  * @QDF_MODULE_ID_SM_ENGINE: SM engine module ID
389  * @QDF_MODULE_ID_CMN_MLME: CMN MLME module ID
390  * @QDF_MODULE_ID_CFR: CFR module ID
391  * @QDF_MODULE_ID_DP_TX_CAPTURE: Tx capture enhancement feature ID
392  * @QDF_MODULE_ID_INTEROP_ISSUES_AP: interop issues ap module ID
393  * @QDF_MODULE_ID_DENYLIST_MGR: Denylist Manager module
394  * @QDF_MODULE_ID_QLD: QCA Live Debug module ID
395  * @QDF_MODULE_ID_DYNAMIC_MODE_CHG: Dynamic mode change module ID
396  * @QDF_MODULE_ID_COEX: Coex related config module ID
397  * @QDF_MODULE_ID_FTM_TIME_SYNC: FTM Time sync module ID
398  * @QDF_MODULE_ID_PKT_CAPTURE: PACKET CAPTURE module ID
399  * @QDF_MODULE_ID_MON_FILTER: Monitor filter related config module ID
400  * @QDF_MODULE_ID_DCS: DCS module ID
401  * @QDF_MODULE_ID_RPTR: Repeater module ID
402  * @QDF_MODULE_ID_6GHZ: 6Ghz specific feature ID
403  * @QDF_MODULE_ID_IOT_SIM: IOT Simulation for rogue AP module ID
404  * @QDF_MODULE_ID_IFMGR: Interface Manager feature ID
405  * @QDF_MODULE_ID_MSCS: MSCS feature ID
406  * @QDF_MODULE_ID_GPIO: GPIO configuration module ID
407  * @QDF_MODULE_ID_DIAG: Host diag module ID
408  * @QDF_MODULE_ID_DP_INIT: INIT/DEINIT path of datapath module ID
409  * @QDF_MODULE_ID_DP_TX: TX path of datapath module ID
410  * @QDF_MODULE_ID_DP_RX: RX path of datapath module ID
411  * @QDF_MODULE_ID_DP_STATS: TX/RX stats, AST stats module ID
412  * @QDF_MODULE_ID_DP_HTT: Firmware to host DP event handling module ID
413  * @QDF_MODULE_ID_DP_PEER: DP peer module ID
414  * @QDF_MODULE_ID_DP_RX_ERROR: Packet handling from WBM release ring module ID
415  * @QDF_MODULE_ID_DP_HTT_TX_STATS: FW to host Tx  PPDU stats module ID
416  * @QDF_MODULE_ID_DP_RX_MON_STATUS: RX mon status ring module ID
417  * @QDF_MODULE_ID_DP_RX_MON_DEST: Monitor ode processing module ID
418  * @QDF_MODULE_ID_DP_REO: REO command status module ID
419  * @QDF_MODULE_ID_DP_TX_COMP: TX completion module ID
420  * @QDF_MODULE_ID_DP_VDEV: DP Vdev module ID
421  * @QDF_MODULE_ID_DP_CDP: Configuration module ID
422  * @QDF_MODULE_ID_TSO: TSO module ID
423  * @QDF_MODULE_ID_ME: Multicast Enhancement module ID
424  * @QDF_MODULE_ID_QWRAP: QWRAP module ID
425  * @QDF_MODULE_ID_DBDC_REP: DBDC repeater module ID
426  * @QDF_MODULE_ID_EXT_AP: Extended AP module ID
427  * @QDF_MODULE_ID_MLO: MLO Manager module ID
428  * @QDF_MODULE_ID_MLOIE: MLO related IE protocol processing module ID
429  * @QDF_MODULE_ID_MBSS: MBSS Framework module ID
430  * @QDF_MODULE_ID_MON: Monitor module ID
431  * @QDF_MODULE_ID_MGMT_RX_REO: Management rx-reorder module ID
432  * @QDF_MODULE_ID_AFC: AFC module ID
433  * @QDF_MODULE_ID_WIFI_RADAR: WIFI RADAR module ID
434  * @QDF_MODULE_ID_TWT: TWT module ID
435  * @QDF_MODULE_ID_WLAN_PRE_CAC: WLAN PRE CAC module ID
436  * @QDF_MODULE_ID_T2LM: T2LM module ID
437  * @QDF_MODULE_ID_DP_SAWF: DP SAWF module ID
438  * @QDF_MODULE_ID_SCS: SCS module ID
439  * @QDF_MODULE_ID_ANY: anything
440  * @QDF_MODULE_ID_MAX: Max place holder module ID
441  *
442  * New module ID needs to be added in qdf trace along with this enum.
443  */
444 typedef enum {
445 	QDF_MODULE_ID_MIN       = 0,
446 	QDF_MODULE_ID_TDLS      = QDF_MODULE_ID_MIN,
447 	QDF_MODULE_ID_ACS,
448 	QDF_MODULE_ID_SCAN_SM,
449 	QDF_MODULE_ID_SCANENTRY,
450 	QDF_MODULE_ID_WDS,
451 	QDF_MODULE_ID_ACTION,
452 	QDF_MODULE_ID_ROAM,
453 	QDF_MODULE_ID_INACT,
454 	QDF_MODULE_ID_DOTH      = 8,
455 	QDF_MODULE_ID_IQUE,
456 	QDF_MODULE_ID_WME,
457 	QDF_MODULE_ID_ACL,
458 	QDF_MODULE_ID_WPA,
459 	QDF_MODULE_ID_RADKEYS,
460 	QDF_MODULE_ID_RADDUMP,
461 	QDF_MODULE_ID_RADIUS,
462 	QDF_MODULE_ID_DOT1XSM   = 16,
463 	QDF_MODULE_ID_DOT1X,
464 	QDF_MODULE_ID_POWER,
465 	QDF_MODULE_ID_STATE,
466 	QDF_MODULE_ID_OUTPUT,
467 	QDF_MODULE_ID_SCAN,
468 	QDF_MODULE_ID_AUTH,
469 	QDF_MODULE_ID_ASSOC,
470 	QDF_MODULE_ID_NODE      = 24,
471 	QDF_MODULE_ID_ELEMID,
472 	QDF_MODULE_ID_XRATE,
473 	QDF_MODULE_ID_INPUT,
474 	QDF_MODULE_ID_CRYPTO,
475 	QDF_MODULE_ID_DUMPPKTS,
476 	QDF_MODULE_ID_DEBUG,
477 	QDF_MODULE_ID_MLME,
478 	QDF_MODULE_ID_RRM       = 32,
479 	QDF_MODULE_ID_WNM,
480 	QDF_MODULE_ID_P2P_PROT,
481 	QDF_MODULE_ID_PROXYARP,
482 	QDF_MODULE_ID_L2TIF,
483 	QDF_MODULE_ID_WIFIPOS,
484 	QDF_MODULE_ID_WRAP,
485 	QDF_MODULE_ID_DFS,
486 	QDF_MODULE_ID_ATF       = 40,
487 	QDF_MODULE_ID_SPLITMAC,
488 	QDF_MODULE_ID_IOCTL,
489 	QDF_MODULE_ID_NAC,
490 	QDF_MODULE_ID_MESH,
491 	QDF_MODULE_ID_MBO,
492 	QDF_MODULE_ID_EXTIOCTL_CHANSWITCH,
493 	QDF_MODULE_ID_EXTIOCTL_CHANSSCAN,
494 	QDF_MODULE_ID_TLSHIM    = 48,
495 	QDF_MODULE_ID_WMI,
496 	QDF_MODULE_ID_HTT,
497 	QDF_MODULE_ID_HDD,
498 	QDF_MODULE_ID_SME,
499 	QDF_MODULE_ID_PE,
500 	QDF_MODULE_ID_WMA,
501 	QDF_MODULE_ID_SYS,
502 	QDF_MODULE_ID_QDF       = 56,
503 	QDF_MODULE_ID_SAP,
504 	QDF_MODULE_ID_HDD_SOFTAP,
505 	QDF_MODULE_ID_HDD_DATA,
506 	QDF_MODULE_ID_HDD_SAP_DATA,
507 	QDF_MODULE_ID_HIF,
508 	QDF_MODULE_ID_HTC,
509 	QDF_MODULE_ID_TXRX,
510 	QDF_MODULE_ID_QDF_DEVICE = 64,
511 	QDF_MODULE_ID_CFG,
512 	QDF_MODULE_ID_BMI,
513 	QDF_MODULE_ID_EPPING,
514 	QDF_MODULE_ID_QVIT,
515 	QDF_MODULE_ID_DP,
516 	QDF_MODULE_ID_HAL,
517 	QDF_MODULE_ID_SOC,
518 	QDF_MODULE_ID_OS_IF,
519 	QDF_MODULE_ID_TARGET_IF,
520 	QDF_MODULE_ID_SCHEDULER,
521 	QDF_MODULE_ID_MGMT_TXRX,
522 	QDF_MODULE_ID_SERIALIZATION,
523 	QDF_MODULE_ID_PMO,
524 	QDF_MODULE_ID_P2P,
525 	QDF_MODULE_ID_POLICY_MGR,
526 	QDF_MODULE_ID_CONFIG,
527 	QDF_MODULE_ID_REGULATORY,
528 	QDF_MODULE_ID_SA_API,
529 	QDF_MODULE_ID_NAN,
530 	QDF_MODULE_ID_OFFCHAN_TXRX,
531 	QDF_MODULE_ID_SON,
532 	QDF_MODULE_ID_SPECTRAL,
533 	QDF_MODULE_ID_OBJ_MGR,
534 	QDF_MODULE_ID_NSS,
535 	QDF_MODULE_ID_ROAM_DEBUG,
536 	QDF_MODULE_ID_CDP,
537 	QDF_MODULE_ID_DIRECT_BUF_RX,
538 	QDF_MODULE_ID_DISA,
539 	QDF_MODULE_ID_GREEN_AP,
540 	QDF_MODULE_ID_FTM,
541 	QDF_MODULE_ID_FD,
542 	QDF_MODULE_ID_OCB,
543 	QDF_MODULE_ID_IPA,
544 	QDF_MODULE_ID_CP_STATS,
545 	QDF_MODULE_ID_ACTION_OUI,
546 	QDF_MODULE_ID_TARGET,
547 	QDF_MODULE_ID_MBSSIE,
548 	QDF_MODULE_ID_FWOL,
549 	QDF_MODULE_ID_SM_ENGINE,
550 	QDF_MODULE_ID_CMN_MLME,
551 	QDF_MODULE_ID_BSSCOLOR,
552 	QDF_MODULE_ID_CFR,
553 	QDF_MODULE_ID_DP_TX_CAPTURE,
554 	QDF_MODULE_ID_INTEROP_ISSUES_AP,
555 	QDF_MODULE_ID_DENYLIST_MGR,
556 	QDF_MODULE_ID_QLD,
557 	QDF_MODULE_ID_DYNAMIC_MODE_CHG,
558 	QDF_MODULE_ID_COEX,
559 	QDF_MODULE_ID_FTM_TIME_SYNC,
560 	QDF_MODULE_ID_PKT_CAPTURE,
561 	QDF_MODULE_ID_MON_FILTER,
562 	QDF_MODULE_ID_DCS,
563 	QDF_MODULE_ID_RPTR,
564 	QDF_MODULE_ID_6GHZ,
565 	QDF_MODULE_ID_IOT_SIM,
566 	QDF_MODULE_ID_IFMGR,
567 	QDF_MODULE_ID_MSCS,
568 	QDF_MODULE_ID_GPIO,
569 	QDF_MODULE_ID_DIAG,
570 	QDF_MODULE_ID_DP_INIT,
571 	QDF_MODULE_ID_DP_TX,
572 	QDF_MODULE_ID_DP_RX,
573 	QDF_MODULE_ID_DP_STATS,
574 	QDF_MODULE_ID_DP_HTT,
575 	QDF_MODULE_ID_DP_PEER,
576 	QDF_MODULE_ID_DP_RX_ERROR,
577 	QDF_MODULE_ID_DP_HTT_TX_STATS,
578 	QDF_MODULE_ID_DP_RX_MON_STATUS,
579 	QDF_MODULE_ID_DP_RX_MON_DEST,
580 	QDF_MODULE_ID_DP_REO,
581 	QDF_MODULE_ID_DP_TX_COMP,
582 	QDF_MODULE_ID_DP_VDEV,
583 	QDF_MODULE_ID_DP_CDP,
584 	QDF_MODULE_ID_TSO,
585 	QDF_MODULE_ID_ME,
586 	QDF_MODULE_ID_QWRAP,
587 	QDF_MODULE_ID_DBDC_REP,
588 	QDF_MODULE_ID_EXT_AP,
589 	QDF_MODULE_ID_MLO,
590 	QDF_MODULE_ID_MLOIE,
591 	QDF_MODULE_ID_MBSS,
592 	QDF_MODULE_ID_MON,
593 	QDF_MODULE_ID_MGMT_RX_REO,
594 	QDF_MODULE_ID_AFC,
595 	QDF_MODULE_ID_WIFI_RADAR,
596 	QDF_MODULE_ID_TWT,
597 	QDF_MODULE_ID_DP_UMAC_RESET,
598 	QDF_MODULE_ID_WLAN_PRE_CAC,
599 	QDF_MODULE_ID_T2LM,
600 	QDF_MODULE_ID_DP_SAWF,
601 	QDF_MODULE_ID_SCS,
602 	QDF_MODULE_ID_ANY,
603 	QDF_MODULE_ID_MAX,
604 } QDF_MODULE_ID;
605 
606 /**
607  * typedef enum QDF_TRACE_LEVEL - Debug verbose level
608  * @QDF_TRACE_LEVEL_NONE: no trace will be logged. This value is in place
609  *			  for the qdf_trace_setlevel() to allow the user
610  *			  to turn off all traces
611  * @QDF_TRACE_LEVEL_FATAL: Indicates fatal error conditions
612  * @QDF_TRACE_LEVEL_ERROR: Indicates error conditions
613  * @QDF_TRACE_LEVEL_WARN: May indicate that an error will occur if action
614  *			  is not taken
615  * @QDF_TRACE_LEVEL_INFO: Normal operational messages that require no action
616  * @QDF_TRACE_LEVEL_INFO_HIGH: High level operational messages that require
617  *			       no action
618  * @QDF_TRACE_LEVEL_INFO_MED: Middle level operational messages that require
619  *			      no action
620  * @QDF_TRACE_LEVEL_INFO_LOW: Low level operational messages that require
621  *			      no action
622  * @QDF_TRACE_LEVEL_DEBUG: Information useful to developers for debugging
623  * @QDF_TRACE_LEVEL_TRACE: Indicates trace level for automation scripts,
624  *			whenever there is a context switch in driver, one
625  *			print using this trace level will be added with
626  *			the help of qdf_trace api.
627  * @QDF_TRACE_LEVEL_ALL: All trace levels
628  * @QDF_TRACE_LEVEL_MAX: Max trace level
629  */
630 typedef enum {
631 	QDF_TRACE_LEVEL_NONE,
632 	QDF_TRACE_LEVEL_FATAL,
633 	QDF_TRACE_LEVEL_ERROR,
634 	QDF_TRACE_LEVEL_WARN,
635 	QDF_TRACE_LEVEL_INFO,
636 	QDF_TRACE_LEVEL_INFO_HIGH,
637 	QDF_TRACE_LEVEL_INFO_MED,
638 	QDF_TRACE_LEVEL_INFO_LOW,
639 	QDF_TRACE_LEVEL_DEBUG,
640 	QDF_TRACE_LEVEL_TRACE,
641 	QDF_TRACE_LEVEL_ALL,
642 	QDF_TRACE_LEVEL_MAX
643 } QDF_TRACE_LEVEL;
644 
645 /**
646  * enum QDF_OPMODE - vdev operating mode
647  * @QDF_STA_MODE: STA mode
648  * @QDF_SAP_MODE: SAP mode
649  * @QDF_P2P_CLIENT_MODE: P2P client mode
650  * @QDF_P2P_GO_MODE: P2P GO mode
651  * @QDF_FTM_MODE: FTM mode
652  * @QDF_IBSS_MODE: IBSS mode
653  * @QDF_MONITOR_MODE: Monitor mode
654  * @QDF_P2P_DEVICE_MODE: P2P device mode
655  * @QDF_OCB_MODE: OCB device mode
656  * @QDF_EPPING_MODE: EPPING device mode
657  * @QDF_QVIT_MODE: QVIT device mode
658  * @QDF_NDI_MODE: NAN datapath mode
659  * @QDF_WDS_MODE: WDS mode
660  * @QDF_BTAMP_MODE: BTAMP mode
661  * @QDF_AHDEMO_MODE: AHDEMO mode
662  * @QDF_TDLS_MODE: TDLS device mode
663  * @QDF_NAN_DISC_MODE: NAN Discovery device mode
664  * @QDF_MAX_NO_OF_MODE: Max place holder
665  *
666  * These are generic IDs that identify the various roles
667  * in the software system
668  */
669 enum QDF_OPMODE {
670 	QDF_STA_MODE,
671 	QDF_SAP_MODE,
672 	QDF_P2P_CLIENT_MODE,
673 	QDF_P2P_GO_MODE,
674 	QDF_FTM_MODE,
675 	QDF_IBSS_MODE,
676 	QDF_MONITOR_MODE,
677 	QDF_P2P_DEVICE_MODE,
678 	QDF_OCB_MODE,
679 	QDF_EPPING_MODE,
680 	QDF_QVIT_MODE,
681 	QDF_NDI_MODE,
682 	QDF_WDS_MODE,
683 	QDF_BTAMP_MODE,
684 	QDF_AHDEMO_MODE,
685 	QDF_TDLS_MODE,
686 	QDF_NAN_DISC_MODE,
687 
688 	/* Add new OP Modes to qdf_opmode_str as well */
689 
690 	QDF_MAX_NO_OF_MODE
691 };
692 
693 /**
694  * qdf_opmode_str() - Return a human readable string representation of @opmode
695  * @opmode: The opmode to convert
696  *
697  * Return: string representation of @opmode
698  */
699 const char *qdf_opmode_str(const enum QDF_OPMODE opmode);
700 
701 /**
702  * enum QDF_GLOBAL_MODE - global mode when driver is loaded.
703  *
704  * @QDF_GLOBAL_MISSION_MODE: mission mode (STA, SAP...)
705  * @QDF_GLOBAL_WALTEST_MODE: WAL Test Mode
706  * @QDF_GLOBAL_MONITOR_MODE: Monitor Mode
707  * @QDF_GLOBAL_FTM_MODE: FTM mode
708  * @QDF_GLOBAL_IBSS_MODE: IBSS mode
709  * @QDF_GLOBAL_COLDBOOT_CALIB_MODEL: Cold Boot Calibration Mode
710  * @QDF_GLOBAL_EPPING_MODE: EPPING mode
711  * @QDF_GLOBAL_QVIT_MODE: QVIT global mode
712  * @QDF_GLOBAL_FTM_COLDBOOT_CALIB_MODE: Cold Boot Calibration in FTM Mode
713  * @QDF_GLOBAL_MAX_MODE: Max place holder
714  */
715 enum QDF_GLOBAL_MODE {
716 	QDF_GLOBAL_MISSION_MODE,
717 	QDF_GLOBAL_WALTEST_MODE = 3,
718 	QDF_GLOBAL_MONITOR_MODE = 4,
719 	QDF_GLOBAL_FTM_MODE = 5,
720 	QDF_GLOBAL_IBSS_MODE = 6,
721 	QDF_GLOBAL_COLDBOOT_CALIB_MODE = 7,
722 	QDF_GLOBAL_EPPING_MODE = 8,
723 	QDF_GLOBAL_QVIT_MODE = 9,
724 	QDF_GLOBAL_FTM_COLDBOOT_CALIB_MODE = 10,
725 	QDF_GLOBAL_MAX_MODE
726 };
727 
728 #define  QDF_IS_EPPING_ENABLED(mode) (mode == QDF_GLOBAL_EPPING_MODE)
729 
730 #ifdef QDF_TRACE_PRINT_ENABLE
731 #define qdf_print(args...) QDF_TRACE_INFO(QDF_MODULE_ID_ANY, ## args)
732 #define qdf_alert(args...) QDF_TRACE_FATAL(QDF_MODULE_ID_ANY, ## args)
733 #define qdf_err(args...)   QDF_TRACE_ERROR(QDF_MODULE_ID_ANY, ## args)
734 #define qdf_warn(args...)  QDF_TRACE_WARN(QDF_MODULE_ID_ANY, ## args)
735 #define qdf_info(args...)  QDF_TRACE_INFO(QDF_MODULE_ID_ANY, ## args)
736 #define qdf_debug(args...) QDF_TRACE_DEBUG(QDF_MODULE_ID_ANY, ## args)
737 
738 #define qdf_nofl_print(params...) \
739 	QDF_TRACE_INFO_NO_FL(QDF_MODULE_ID_ANY, ## params)
740 #define qdf_nofl_alert(params...) \
741 	QDF_TRACE_FATAL_NO_FL(QDF_MODULE_ID_ANY, ## params)
742 #define qdf_nofl_err(params...) \
743 	QDF_TRACE_ERROR_NO_FL(QDF_MODULE_ID_ANY, ## params)
744 #define qdf_nofl_warn(params...) \
745 	QDF_TRACE_WARN_NO_FL(QDF_MODULE_ID_ANY, ## params)
746 #define qdf_nofl_info(params...) \
747 	QDF_TRACE_INFO_NO_FL(QDF_MODULE_ID_ANY, ## params)
748 #define qdf_nofl_debug(params...) \
749 	QDF_TRACE_DEBUG_NO_FL(QDF_MODULE_ID_ANY, ## params)
750 
751 #else /* QDF_TRACE_PRINT_ENABLE */
752 #define qdf_print(params...) QDF_TRACE_ERROR(QDF_MODULE_ID_QDF, ## params)
753 #define qdf_alert(params...) QDF_TRACE_FATAL(QDF_MODULE_ID_QDF, ## params)
754 #define qdf_err(params...) QDF_TRACE_ERROR(QDF_MODULE_ID_QDF, ## params)
755 #define qdf_warn(params...) QDF_TRACE_WARN(QDF_MODULE_ID_QDF, ## params)
756 #define qdf_info(params...) QDF_TRACE_INFO(QDF_MODULE_ID_QDF, ## params)
757 #define qdf_debug(params...) QDF_TRACE_DEBUG(QDF_MODULE_ID_QDF, ## params)
758 
759 #define qdf_nofl_alert(params...) \
760 	QDF_TRACE_FATAL_NO_FL(QDF_MODULE_ID_QDF, ## params)
761 #define qdf_nofl_err(params...) \
762 	QDF_TRACE_ERROR_NO_FL(QDF_MODULE_ID_QDF, ## params)
763 #define qdf_nofl_warn(params...) \
764 	QDF_TRACE_WARN_NO_FL(QDF_MODULE_ID_QDF, ## params)
765 #define qdf_nofl_info(params...) \
766 	QDF_TRACE_INFO_NO_FL(QDF_MODULE_ID_QDF, ## params)
767 #define qdf_nofl_debug(params...) \
768 	QDF_TRACE_DEBUG_NO_FL(QDF_MODULE_ID_QDF, ## params)
769 
770 #endif /* QDF_TRACE_PRINT_ENABLE */
771 
772 #define qdf_rl_alert(params...) QDF_TRACE_FATAL_RL(QDF_MODULE_ID_QDF, ## params)
773 #define qdf_rl_err(params...) QDF_TRACE_ERROR_RL(QDF_MODULE_ID_QDF, ## params)
774 #define qdf_rl_warn(params...) QDF_TRACE_WARN_RL(QDF_MODULE_ID_QDF, ## params)
775 #define qdf_rl_info(params...) QDF_TRACE_INFO_RL(QDF_MODULE_ID_QDF, ## params)
776 #define qdf_rl_debug(params...) QDF_TRACE_DEBUG_RL(QDF_MODULE_ID_QDF, ## params)
777 
778 #define qdf_rl_nofl_alert(params...) \
779 	QDF_TRACE_FATAL_RL_NO_FL(QDF_MODULE_ID_QDF, ## params)
780 #define qdf_rl_nofl_err(params...) \
781 	QDF_TRACE_ERROR_RL_NO_FL(QDF_MODULE_ID_QDF, ## params)
782 #define qdf_rl_nofl_warn(params...) \
783 	QDF_TRACE_WARN_RL_NO_FL(QDF_MODULE_ID_QDF, ## params)
784 #define qdf_rl_nofl_info(params...) \
785 	QDF_TRACE_INFO_RL_NO_FL(QDF_MODULE_ID_QDF, ## params)
786 #define qdf_rl_nofl_debug(params...) \
787 	QDF_TRACE_DEBUG_RL_NO_FL(QDF_MODULE_ID_QDF, ## params)
788 
789 #define qdf_snprint   __qdf_snprint
790 
791 #define qdf_kstrtoint __qdf_kstrtoint
792 #define qdf_kstrtouint __qdf_kstrtouint
793 
794 #ifdef WLAN_OPEN_P2P_INTERFACE
795 /* This should match with WLAN_MAX_INTERFACES */
796 #define QDF_MAX_CONCURRENCY_PERSONA  (WLAN_MAX_VDEVS)
797 #else
798 #define QDF_MAX_CONCURRENCY_PERSONA  (WLAN_MAX_VDEVS - 1)
799 #endif
800 
801 #define QDF_STA_MASK (1 << QDF_STA_MODE)
802 #define QDF_SAP_MASK (1 << QDF_SAP_MODE)
803 #define QDF_P2P_CLIENT_MASK (1 << QDF_P2P_CLIENT_MODE)
804 #define QDF_P2P_GO_MASK (1 << QDF_P2P_GO_MODE)
805 #define QDF_MONITOR_MASK (1 << QDF_MONITOR_MODE)
806 
807 #ifdef FEATURE_WLAN_MCC_TO_SCC_SWITCH
808 
809 /**
810  * typedef tQDF_MCC_TO_SCC_SWITCH_MODE - MCC to SCC switch mode.
811  * @QDF_MCC_TO_SCC_SWITCH_DISABLE: Disable switch
812  * @QDF_MCC_TO_SCC_SWITCH_FORCE_WITHOUT_DISCONNECTION: Force switch without
813  * restart of SAP
814  * @QDF_MCC_TO_SCC_SWITCH_WITH_FAVORITE_CHANNEL: Switch using fav channel(s)
815  * without SAP restart
816  * @QDF_MCC_TO_SCC_SWITCH_FORCE_PREFERRED_WITHOUT_DISCONNECTION: Force switch
817  * without SAP restart. MCC is allowed only in below exception cases:
818  *	Exception Case-1: When STA is operating on DFS channel.
819  *	Exception Case-2: When STA is operating on LTE-CoEx channel.
820  *	Exception Case-3: When STA is operating on AP disabled channel.
821  * @QDF_MCC_TO_SCC_WITH_PREFERRED_BAND: Force SCC only in user preferred band.
822  * Allow MCC if STA is operating or comes up on other than user preferred band.
823  *
824  * @QDF_MCC_TO_SCC_SWITCH_MAX: max switch
825  */
826 typedef enum {
827 	QDF_MCC_TO_SCC_SWITCH_DISABLE = 0,
828 	QDF_MCC_TO_SCC_SWITCH_FORCE_WITHOUT_DISCONNECTION = 3,
829 	QDF_MCC_TO_SCC_SWITCH_WITH_FAVORITE_CHANNEL,
830 	QDF_MCC_TO_SCC_SWITCH_FORCE_PREFERRED_WITHOUT_DISCONNECTION,
831 	QDF_MCC_TO_SCC_WITH_PREFERRED_BAND,
832 	QDF_MCC_TO_SCC_SWITCH_MAX
833 } tQDF_MCC_TO_SCC_SWITCH_MODE;
834 #endif
835 
836 #if !defined(NULL)
837 #ifdef __cplusplus
838 #define NULL   0
839 #else
840 #define NULL   ((void *)0)
841 #endif
842 #endif
843 
844 /**
845  * qdf_bool_parse() - parse the given string as a boolean value
846  * @bool_str: the input boolean string to parse
847  * @out_bool: the output boolean value, populated on success
848  *
849  * 1, y, Y are mapped to true, 0, n, N are mapped to false.
850  * Leading/trailing whitespace is ignored.
851  *
852  * Return: QDF_STATUS
853  */
854 QDF_STATUS qdf_bool_parse(const char *bool_str, bool *out_bool);
855 
856 /**
857  * qdf_int32_parse() - parse the given string as a 32-bit signed integer
858  * @int_str: the input integer string to parse
859  * @out_int: the output integer value, populated on success
860  *
861  * Supports binary (0b), octal (0o), decimal (no prefix), and hexadecimal (0x)
862  * encodings via typical prefix notation. Leading/trailing whitespace is
863  * ignored.
864  *
865  * Return: QDF_STATUS
866  */
867 QDF_STATUS qdf_int32_parse(const char *int_str, int32_t *out_int);
868 
869 /**
870  * qdf_uint32_parse() - parse the given string as a 32-bit unsigned integer
871  * @int_str: the input integer string to parse
872  * @out_int: the output integer value, populated on success
873  *
874  * Supports binary (0b), octal (0o), decimal (no prefix), and hexadecimal (0x)
875  * encodings via typical prefix notation. Leading/trailing whitespace is
876  * ignored.
877  *
878  * Return: QDF_STATUS
879  */
880 QDF_STATUS qdf_uint32_parse(const char *int_str, uint32_t *out_int);
881 
882 /**
883  * qdf_int64_parse() - parse the given string as a 64-bit signed integer
884  * @int_str: the input integer string to parse
885  * @out_int: the output integer value, populated on success
886  *
887  * Supports binary (0b), octal (0o), decimal (no prefix), and hexadecimal (0x)
888  * encodings via typical prefix notation. Leading/trailing whitespace is
889  * ignored.
890  *
891  * Return: QDF_STATUS
892  */
893 QDF_STATUS qdf_int64_parse(const char *int_str, int64_t *out_int);
894 
895 /**
896  * qdf_uint64_parse() - parse the given string as a 64-bit unsigned integer
897  * @int_str: the input integer string to parse
898  * @out_int: the output integer value, populated on success
899  *
900  * Supports binary (0b), octal (0o), decimal (no prefix), and hexadecimal (0x)
901  * encodings via typical prefix notation. Leading/trailing whitespace is
902  * ignored.
903  *
904  * Return: QDF_STATUS
905  */
906 QDF_STATUS qdf_uint64_parse(const char *int_str, uint64_t *out_int);
907 
908 #define QDF_MAC_ADDR_SIZE 6
909 
910 /**
911  * If the feature CONFIG_WLAN_TRACE_HIDE_MAC_ADDRESS is enabled,
912  * then the requirement is to hide 2nd, 3rd and 4th octet of the
913  * MAC address in the kernel logs and driver logs.
914  * But other management interfaces like ioctl, debugfs, sysfs,
915  * wext, unit test code or non-production simulator sw (iot_sim)
916  * should continue to log the full mac address.
917  *
918  * Developers must use QDF_FULL_MAC_FMT instead of "%pM",
919  * as this macro helps avoid accidentally breaking the feature
920  * CONFIG_WLAN_TRACE_HIDE_MAC_ADDRESS if enabled and code auditing
921  * becomes easy.
922  */
923 #define QDF_FULL_MAC_FMT "%pM"
924 #define QDF_FULL_MAC_REF(a) (a)
925 
926 #if defined(WLAN_TRACE_HIDE_MAC_ADDRESS)
927 #define QDF_MAC_ADDR_FMT "%02x:**:**:**:%02x:%02x"
928 
929 /*
930  * The input data type for QDF_MAC_ADDR_REF can be pointer or an array.
931  * In case of array, compiler was throwing following warning
932  * 'address of array will always evaluate as ‘true’
933  * and if the pointer is NULL, zero is passed to the format specifier
934  * which results in zero mac address (00:**:**:**:00:00)
935  * For this reason, input data type is typecasted to (uintptr_t).
936  */
937 #define QDF_MAC_ADDR_REF(a) \
938 	(((uintptr_t)NULL != (uintptr_t)(a)) ? (a)[0] : 0), \
939 	(((uintptr_t)NULL != (uintptr_t)(a)) ? (a)[4] : 0), \
940 	(((uintptr_t)NULL != (uintptr_t)(a)) ? (a)[5] : 0)
941 #else
942 #define QDF_MAC_ADDR_FMT "%pM"
943 #define QDF_MAC_ADDR_REF(a) (a)
944 #endif /* WLAN_TRACE_HIDE_MAC_ADDRESS */
945 
946 #define QDF_MAC_ADDR_BCAST_INIT { { 0xff, 0xff, 0xff, 0xff, 0xff, 0xff } }
947 #define QDF_MAC_ADDR_ZERO_INIT { { 0, 0, 0, 0, 0, 0 } }
948 
949 /**
950  * struct qdf_mac_addr - A MAC address
951  * @bytes: the raw address bytes array
952  */
953 struct qdf_mac_addr {
954 	uint8_t bytes[QDF_MAC_ADDR_SIZE];
955 };
956 
957 /**
958  * enum qdf_proto_subtype - subtype of packet
959  * @QDF_PROTO_EAPOL_M1 - EAPOL 1/4
960  * @QDF_PROTO_EAPOL_M2 - EAPOL 2/4
961  * @QDF_PROTO_EAPOL_M3 - EAPOL 3/4
962  * @QDF_PROTO_EAPOL_M4 - EAPOL 4/4
963  * @QDF_PROTO_DHCP_DISCOVER - discover
964  * @QDF_PROTO_DHCP_REQUEST - request
965  * @QDF_PROTO_DHCP_OFFER - offer
966  * @QDF_PROTO_DHCP_ACK - ACK
967  * @QDF_PROTO_DHCP_NACK - NACK
968  * @QDF_PROTO_DHCP_RELEASE - release
969  * @QDF_PROTO_DHCP_INFORM - inform
970  * @QDF_PROTO_DHCP_DECLINE - decline
971  * @QDF_PROTO_ARP_REQ - arp request
972  * @QDF_PROTO_ARP_RES - arp response
973  * @QDF_PROTO_ICMP_REQ - icmp request
974  * @QDF_PROTO_ICMP_RES - icmp response
975  * @QDF_PROTO_ICMPV6_REQ - icmpv6 request
976  * @QDF_PROTO_ICMPV6_RES - icmpv6 response
977  * @QDF_PROTO_ICMPV6_RS - icmpv6 rs packet
978  * @QDF_PROTO_ICMPV6_RA - icmpv6 ra packet
979  * @QDF_PROTO_ICMPV6_NS - icmpv6 ns packet
980  * @QDF_PROTO_ICMPV6_NA - icmpv6 na packet
981  * @QDF_PROTO_IPV4_UDP - ipv4 udp
982  * @QDF_PROTO_IPV4_TCP - ipv4 tcp
983  * @QDF_PROTO_IPV6_UDP - ipv6 udp
984  * @QDF_PROTO_IPV6_TCP - ipv6 tcp
985  * @QDF_PROTO_MGMT_ASSOC -assoc
986  * @QDF_PROTO_MGMT_DISASSOC - disassoc
987  * @QDF_PROTO_MGMT_AUTH - auth
988  * @QDF_PROTO_MGMT_DEAUTH - deauth
989  * @QDF_ROAM_SYNCH - roam synch indication from fw
990  * @QDF_ROAM_COMPLETE - roam complete cmd to fw
991  * @QDF_ROAM_EVENTID - roam eventid from fw
992  * @QDF_PROTO_DNS_QUERY - dns query
993  * @QDF_PROTO_DNS_RES -dns response
994  */
995 enum qdf_proto_subtype {
996 	QDF_PROTO_INVALID,
997 	QDF_PROTO_EAPOL_M1,
998 	QDF_PROTO_EAPOL_M2,
999 	QDF_PROTO_EAPOL_M3,
1000 	QDF_PROTO_EAPOL_M4,
1001 	QDF_PROTO_DHCP_DISCOVER,
1002 	QDF_PROTO_DHCP_REQUEST,
1003 	QDF_PROTO_DHCP_OFFER,
1004 	QDF_PROTO_DHCP_ACK,
1005 	QDF_PROTO_DHCP_NACK,
1006 	QDF_PROTO_DHCP_RELEASE,
1007 	QDF_PROTO_DHCP_INFORM,
1008 	QDF_PROTO_DHCP_DECLINE,
1009 	QDF_PROTO_ARP_REQ,
1010 	QDF_PROTO_ARP_RES,
1011 	QDF_PROTO_ICMP_REQ,
1012 	QDF_PROTO_ICMP_RES,
1013 	QDF_PROTO_ICMPV6_REQ,
1014 	QDF_PROTO_ICMPV6_RES,
1015 	QDF_PROTO_ICMPV6_RS,
1016 	QDF_PROTO_ICMPV6_RA,
1017 	QDF_PROTO_ICMPV6_NS,
1018 	QDF_PROTO_ICMPV6_NA,
1019 	QDF_PROTO_IPV4_UDP,
1020 	QDF_PROTO_IPV4_TCP,
1021 	QDF_PROTO_IPV6_UDP,
1022 	QDF_PROTO_IPV6_TCP,
1023 	QDF_PROTO_MGMT_ASSOC,
1024 	QDF_PROTO_MGMT_DISASSOC,
1025 	QDF_PROTO_MGMT_AUTH,
1026 	QDF_PROTO_MGMT_DEAUTH,
1027 	QDF_ROAM_SYNCH,
1028 	QDF_ROAM_COMPLETE,
1029 	QDF_ROAM_EVENTID,
1030 	QDF_PROTO_DNS_QUERY,
1031 	QDF_PROTO_DNS_RES,
1032 	QDF_PROTO_SUBTYPE_MAX
1033 };
1034 
1035 /**
1036  * qdf_mac_parse() - parse the given string as a MAC address
1037  * @mac_str: the input MAC address string to parse
1038  * @out_addr: the output MAC address value, populated on success
1039  *
1040  * A MAC address is a set of 6, colon-delimited, hexadecimal encoded octets.
1041  *
1042  * E.g.
1043  *	00:00:00:00:00:00 (zero address)
1044  *	ff:ff:ff:ff:ff:ff (broadcast address)
1045  *	12:34:56:78:90:ab (an arbitrary address)
1046  *
1047  * This implementation also accepts MAC addresses without colons. Historically,
1048  * other delimiters and groupings have been used to represent MAC addresses, but
1049  * these are not supported here. Hexadecimal digits may be in either upper or
1050  * lower case.
1051  *
1052  * Return: QDF_STATUS
1053  */
1054 QDF_STATUS qdf_mac_parse(const char *mac_str, struct qdf_mac_addr *out_addr);
1055 
1056 #define QDF_IPV4_ADDR_SIZE 4
1057 #define QDF_IPV4_ADDR_STR "%d.%d.%d.%d"
1058 #define QDF_IPV4_ADDR_ARRAY(a) (a)[0], (a)[1], (a)[2], (a)[3]
1059 #define QDF_IPV4_ADDR_ZERO_INIT { { 0, 0, 0, 0 } }
1060 
1061 /**
1062  * struct qdf_ipv4_addr - An IPV4 address
1063  * @bytes: the raw address bytes array
1064  */
1065 struct qdf_ipv4_addr {
1066 	uint8_t bytes[QDF_IPV4_ADDR_SIZE];
1067 };
1068 
1069 /**
1070  * qdf_ipv4_parse() - parse the given string as an IPV4 address
1071  * @ipv4_str: the input IPV4 address string to parse
1072  * @out_addr: the output IPV4 address value, populated on success
1073  *
1074  * An IPV4 address is a set of 4, dot-delimited, decimal encoded octets.
1075  *
1076  * E.g.
1077  *	0.0.0.0 (wildcard address)
1078  *	127.0.0.1 (loopback address)
1079  *	255.255.255.255 (broadcast address)
1080  *	192.168.0.1 (an arbitrary address)
1081  *
1082  * Historically, non-decimal encodings have also been used to represent IPV4
1083  * addresses, but these are not supported here.
1084  *
1085  * Return: QDF_STATUS
1086  */
1087 QDF_STATUS qdf_ipv4_parse(const char *ipv4_str, struct qdf_ipv4_addr *out_addr);
1088 
1089 #define QDF_IPV6_ADDR_SIZE 16
1090 #define QDF_IPV6_ADDR_HEXTET_COUNT 8
1091 #define QDF_IPV6_ADDR_STR "%x:%x:%x:%x:%x:%x:%x:%x"
1092 #define QDF_IPV6_ADDR_ARRAY(a) \
1093 	((a)[0] << 8) + (a)[1], ((a)[2] << 8) + (a)[3], \
1094 	((a)[4] << 8) + (a)[5], ((a)[6] << 8) + (a)[7], \
1095 	((a)[8] << 8) + (a)[9], ((a)[10] << 8) + (a)[11], \
1096 	((a)[12] << 8) + (a)[13], ((a)[14] << 8) + (a)[15]
1097 #define QDF_IPV6_ADDR_ZERO_INIT \
1098 	{ { 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0 } }
1099 
1100 /**
1101  * struct qdf_ipv6_addr - An IPV6 address
1102  * @bytes: the raw address bytes array
1103  */
1104 struct qdf_ipv6_addr {
1105 	uint8_t bytes[QDF_IPV6_ADDR_SIZE];
1106 };
1107 
1108 /**
1109  * qdf_ipv6_parse() - parse the given string as an IPV6 address
1110  * @ipv6_str: the input IPV6 address string to parse
1111  * @out_addr: the output IPV6 address value, populated on success
1112  *
1113  * A hextet is a pair of octets. An IPV6 address is a set of 8, colon-delimited,
1114  * hexadecimal encoded hextets. Each hextet may omit leading zeros. One or more
1115  * zero-hextets may be "compressed" using a pair of colons ("::"). Up to one
1116  * such zero-compression is allowed per address.
1117  *
1118  * E.g.
1119  *	0:0:0:0:0:0:0:0 (unspecified address)
1120  *	:: (also the unspecified address)
1121  *	0:0:0:0:0:0:0:1 (loopback address)
1122  *	::1 (also the loopback address)
1123  *	900a:ae7::6 (an arbitrary address)
1124  *	900a:ae7:0:0:0:0:0:6 (the same arbitrary address)
1125  *
1126  * Hexadecimal digits may be in either upper or lower case.
1127  *
1128  * Return: QDF_STATUS
1129  */
1130 QDF_STATUS qdf_ipv6_parse(const char *ipv6_str, struct qdf_ipv6_addr *out_addr);
1131 
1132 /**
1133  * qdf_uint32_array_parse() - parse the given string as uint32 array
1134  * @in_str: the input string to parse
1135  * @out_array: the output uint32 array, populated on success
1136  * @array_size: size of the array
1137  * @out_size: size of the populated array
1138  *
1139  * This API is called to convert string (each value separated by
1140  * a comma) into an uint32 array
1141  *
1142  * Return: QDF_STATUS
1143  */
1144 
1145 QDF_STATUS qdf_uint32_array_parse(const char *in_str, uint32_t *out_array,
1146 				  qdf_size_t array_size, qdf_size_t *out_size);
1147 
1148 /**
1149  * qdf_uint16_array_parse() - parse the given string as uint16 array
1150  * @in_str: the input string to parse
1151  * @out_array: the output uint16 array, populated on success
1152  * @array_size: size of the array
1153  * @out_size: size of the populated array
1154  *
1155  * This API is called to convert string (each value separated by
1156  * a comma) into an uint16 array
1157  *
1158  * Return: QDF_STATUS
1159  */
1160 
1161 QDF_STATUS qdf_uint16_array_parse(const char *in_str, uint16_t *out_array,
1162 				  qdf_size_t array_size, qdf_size_t *out_size);
1163 
1164 /**
1165  * qdf_uint8_array_parse() - parse the given string as uint8 array
1166  * @in_str: the input string to parse
1167  * @out_array: the output uint8 array, populated on success
1168  * @array_size: size of the array
1169  * @out_size: size of the populated array
1170  *
1171  * This API is called to convert string (each byte separated by
1172  * a comma) into an u8 array
1173  *
1174  * Return: QDF_STATUS
1175  */
1176 QDF_STATUS qdf_uint8_array_parse(const char *in_str, uint8_t *out_array,
1177 				 qdf_size_t array_size, qdf_size_t *out_size);
1178 
1179 #define QDF_BCAST_MAC_ADDR (0xFF)
1180 #define QDF_MCAST_IPV4_MAC_ADDR (0x01)
1181 #define QDF_MCAST_IPV6_MAC_ADDR (0x33)
1182 
1183 /**
1184  * struct qdf_tso_frag_t - fragments of a single TCP segment
1185  * @paddr_low_32: Lower 32 bits of the buffer pointer
1186  * @paddr_upper_16: upper 16 bits of the buffer pointer
1187  * @length: length of the buffer
1188  * @vaddr: virtual address
1189  *
1190  * This structure holds the fragments of a single TCP segment of a
1191  * given jumbo TSO network buffer
1192  */
1193 struct qdf_tso_frag_t {
1194 	uint16_t length;
1195 	unsigned char *vaddr;
1196 	qdf_dma_addr_t paddr;
1197 };
1198 
1199 #define FRAG_NUM_MAX 6
1200 #define TSO_SEG_MAGIC_COOKIE 0x1EED
1201 
1202 /**
1203  * struct qdf_tso_flags_t - TSO specific flags
1204  * @tso_enable: Enable transmit segmentation offload
1205  * @tcp_flags_mask: Tcp_flag is inserted into the header based
1206  * on the mask
1207  * @l2_len: L2 length for the msdu
1208  * @ip_len: IP length for the msdu
1209  * @tcp_seq_num: TCP sequence number
1210  * @ip_id: IP identification number
1211  *
1212  * This structure holds the TSO specific flags extracted from the TSO network
1213  * buffer for a given TCP segment
1214  */
1215 struct qdf_tso_flags_t {
1216 	uint32_t tso_enable:1,
1217 			reserved_0a:6,
1218 			fin:1,
1219 			syn:1,
1220 			rst:1,
1221 			psh:1,
1222 			ack:1,
1223 			urg:1,
1224 			ece:1,
1225 			cwr:1,
1226 			ns:1,
1227 			tcp_flags_mask:9,
1228 			reserved_0b:7;
1229 
1230 	uint32_t l2_len:16,
1231 			ip_len:16;
1232 
1233 	uint32_t tcp_seq_num;
1234 
1235 	uint32_t ip_id:16,
1236 			ipv4_checksum_en:1,
1237 			udp_ipv4_checksum_en:1,
1238 			udp_ipv6_checksum_en:1,
1239 			tcp_ipv4_checksum_en:1,
1240 			tcp_ipv6_checksum_en:1,
1241 			partial_checksum_en:1,
1242 			reserved_3a:10;
1243 
1244 	uint32_t checksum_offset:14,
1245 			reserved_4a:2,
1246 			payload_start_offset:14,
1247 			reserved_4b:2;
1248 
1249 	uint32_t payload_end_offset:14,
1250 			reserved_5:18;
1251 };
1252 
1253 /**
1254  * struct qdf_tso_seg_t - single TSO segment
1255  * @tso_flags: TSO flags
1256  * @num_frags: number of fragments
1257  * @total_len: total length of the packet
1258  * @tso_frags: array holding the fragments
1259  *
1260  * This structure holds the information of a single TSO segment of a jumbo
1261  * TSO network buffer
1262  */
1263 struct qdf_tso_seg_t {
1264 	struct qdf_tso_flags_t tso_flags;
1265 	uint32_t num_frags;
1266 	uint32_t total_len;
1267 	struct qdf_tso_frag_t tso_frags[FRAG_NUM_MAX];
1268 };
1269 
1270 /**
1271  * TSO seg elem action caller locations: goes into dbg.history below.
1272  * Needed to be defined outside of the feature so that
1273  * callers can be coded without ifdefs (even if they get
1274  * resolved to nothing)
1275  */
1276 enum tsoseg_dbg_caller_e {
1277 	TSOSEG_LOC_UNDEFINED,
1278 	TSOSEG_LOC_INIT1,
1279 	TSOSEG_LOC_INIT2,
1280 	TSOSEG_LOC_FREE,
1281 	TSOSEG_LOC_ALLOC,
1282 	TSOSEG_LOC_DEINIT,
1283 	TSOSEG_LOC_GETINFO,
1284 	TSOSEG_LOC_FILLHTTSEG,
1285 	TSOSEG_LOC_FILLCMNSEG,
1286 	TSOSEG_LOC_PREPARETSO,
1287 	TSOSEG_LOC_TXPREPLLFAST,
1288 	TSOSEG_LOC_UNMAPTSO,
1289 	TSOSEG_LOC_UNMAPLAST,
1290 	TSOSEG_LOC_FORCE_FREE,
1291 };
1292 #ifdef TSOSEG_DEBUG
1293 
1294 /**
1295  * WARNING: Don't change the history size without changing the wrap
1296  *  code in qdf_tso_seg_dbg_record function
1297  */
1298 #define MAX_TSO_SEG_ACT_HISTORY 16
1299 struct qdf_tso_seg_dbg_history_t {
1300 	uint64_t ts;
1301 	short    id;
1302 };
1303 struct qdf_tso_seg_dbg_t {
1304 	void    *txdesc;  /* owner - (ol_txrx_tx_desc_t *) */
1305 	qdf_atomic_t cur; /* index of last valid entry */
1306 	struct qdf_tso_seg_dbg_history_t h[MAX_TSO_SEG_ACT_HISTORY];
1307 };
1308 #endif /* TSOSEG_DEBUG */
1309 
1310 /**
1311  * qdf_tso_seg_elem_t - tso segment element
1312  * @next: pointer to the next segment
1313  * @seg: instance of segment
1314  */
1315 struct qdf_tso_seg_elem_t {
1316 	struct qdf_tso_seg_elem_t *next;
1317 	struct qdf_tso_seg_t seg;
1318 	uint32_t cookie:13,
1319 		on_freelist:1,
1320 		sent_to_target:1,
1321 		force_free:1;
1322 #ifdef TSOSEG_DEBUG
1323 	struct qdf_tso_seg_dbg_t dbg;
1324 #endif /* TSOSEG_DEBUG */
1325 };
1326 
1327 /**
1328  * struct qdf_tso_num_seg_t - single element to count for num of seg
1329  * @tso_cmn_num_seg: num of seg in a jumbo skb
1330  *
1331  * This structure holds the information of num of segments of a jumbo
1332  * TSO network buffer.
1333  */
1334 struct qdf_tso_num_seg_t {
1335 	uint32_t tso_cmn_num_seg;
1336 };
1337 
1338 /**
1339  * qdf_tso_num_seg_elem_t - num of tso segment element for jumbo skb
1340  * @next: pointer to the next segment
1341  * @num_seg: instance of num of seg
1342  */
1343 struct qdf_tso_num_seg_elem_t {
1344 	struct qdf_tso_num_seg_elem_t *next;
1345 	struct qdf_tso_num_seg_t num_seg;
1346 };
1347 
1348 /**
1349  * struct qdf_tso_info_t - TSO information extracted
1350  * @is_tso: is this is a TSO frame
1351  * @num_segs: number of segments
1352  * @tso_seg_list: list of TSO segments for this jumbo packet
1353  * @curr_seg: segment that is currently being processed
1354  * @tso_num_seg_list: num of tso seg for this jumbo packet
1355  * @msdu_stats_idx: msdu index for tso stats
1356  *
1357  * This structure holds the TSO information extracted after parsing the TSO
1358  * jumbo network buffer. It contains a chain of the TSO segments belonging to
1359  * the jumbo packet
1360  */
1361 struct qdf_tso_info_t {
1362 	uint8_t is_tso;
1363 	uint32_t num_segs;
1364 	struct qdf_tso_seg_elem_t *tso_seg_list;
1365 	struct qdf_tso_seg_elem_t *curr_seg;
1366 	struct qdf_tso_num_seg_elem_t *tso_num_seg_list;
1367 	uint32_t msdu_stats_idx;
1368 };
1369 
1370 /**
1371  * Used to set classify bit in CE desc.
1372  */
1373 #define QDF_CE_TX_CLASSIFY_BIT_S   5
1374 
1375 /**
1376  * QDF_CE_TX_PKT_TYPE_BIT_S - 2 bits starting at bit 6 in CE desc.
1377  */
1378 #define QDF_CE_TX_PKT_TYPE_BIT_S   6
1379 
1380 /**
1381  * QDF_CE_TX_PKT_OFFSET_BIT_S - 12 bits --> 16-27, in the CE desciptor
1382  *  the length of HTT/HTC descriptor
1383  */
1384 #define QDF_CE_TX_PKT_OFFSET_BIT_S  16
1385 
1386 /**
1387  * QDF_CE_TX_PKT_OFFSET_BIT_M - Mask for packet offset in the CE descriptor.
1388  */
1389 #define QDF_CE_TX_PKT_OFFSET_BIT_M   0x0fff0000
1390 
1391 /**
1392  * enum qdf_suspend_type - type of suspend
1393  * @QDF_SYSTEM_SUSPEND: System suspend triggered wlan suspend
1394  * @QDF_RUNTIME_SUSPEND: Runtime pm inactivity timer triggered wlan suspend
1395  * @QDF_UNIT_TEST_WOW_SUSPEND: WoW unit test suspend
1396  */
1397 enum qdf_suspend_type {
1398 	QDF_SYSTEM_SUSPEND,
1399 	QDF_RUNTIME_SUSPEND,
1400 	QDF_UNIT_TEST_WOW_SUSPEND
1401 };
1402 
1403 /**
1404  * enum qdf_hang_reason - host hang/ssr reason
1405  * @QDF_REASON_UNSPECIFIED: Unspecified reason
1406  * @QDF_RX_HASH_NO_ENTRY_FOUND: No Map for the MAC entry for the received frame
1407  * @QDF_PEER_DELETION_TIMEDOUT: peer deletion timeout happened
1408  * @QDF_PEER_UNMAP_TIMEDOUT: peer unmap timeout
1409  * @QDF_SCAN_REQ_EXPIRED: Scan request timed out
1410  * @QDF_SCAN_ATTEMPT_FAILURES: Consecutive Scan attempt failures
1411  * @QDF_GET_MSG_BUFF_FAILURE: Unable to get the message buffer
1412  * @QDF_ACTIVE_LIST_TIMEOUT: Current command processing is timedout
1413  * @QDF_SUSPEND_TIMEOUT: Timeout for an ACK from FW for suspend request
1414  * @QDF_RESUME_TIMEOUT: Timeout for an ACK from FW for resume request
1415  * @QDF_WMI_EXCEED_MAX_PENDING_CMDS: wmi exceed max pending cmd
1416  * @QDF_AP_STA_CONNECT_REQ_TIMEOUT: SAP peer assoc timeout from FW
1417  * @QDF_STA_AP_CONNECT_REQ_TIMEOUT: STA peer assoc timeout from FW
1418  * @QDF_MAC_HW_MODE_CHANGE_TIMEOUT: HW mode change timeout from FW
1419  * @QDF_MAC_HW_MODE_CONFIG_TIMEOUT: HW dual mac cfg timeout from FW
1420  * @QDF_VDEV_START_RESPONSE_TIMED_OUT: Start response timeout from FW
1421  * @QDF_VDEV_RESTART_RESPONSE_TIMED_OUT: Restart response timeout from FW
1422  * @QDF_VDEV_STOP_RESPONSE_TIMED_OUT: Stop response timeout from FW
1423  * @QDF_VDEV_DELETE_RESPONSE_TIMED_OUT: Delete response timeout from FW
1424  * @QDF_VDEV_PEER_DELETE_ALL_RESPONSE_TIMED_OUT: Peer delete all resp timeout
1425  * @QDF_WMI_BUF_SEQUENCE_MISMATCH: WMI Tx completion buffer sequence mismatch
1426  * @QDF_HAL_REG_WRITE_FAILURE: HAL register writing failures
1427  * @QDF_SUSPEND_NO_CREDIT: host lack of credit after suspend
1428  * @QCA_HANG_BUS_FAILURE: Bus failure
1429  * @QDF_TASKLET_CREDIT_LATENCY_DETECT: tasklet or credit latency happened
1430  * @QDF_RX_REG_PKT_ROUTE_ERR: MSDU buf errors exceed thresh in REO err path
1431  * @QDF_VDEV_SM_OUT_OF_SYNC: Vdev SM is out of sync and connect req received
1432  * when already connected
1433  * @QDF_STATS_REQ_TIMEDOUT: Stats request timedout
1434  * @QDF_RSO_STOP_RSP_TIMEOUT: Firmware hasn't sent RSO stop response
1435  */
1436 enum qdf_hang_reason {
1437 	QDF_REASON_UNSPECIFIED,
1438 	QDF_RX_HASH_NO_ENTRY_FOUND,
1439 	QDF_PEER_DELETION_TIMEDOUT,
1440 	QDF_PEER_UNMAP_TIMEDOUT,
1441 	QDF_SCAN_REQ_EXPIRED,
1442 	QDF_SCAN_ATTEMPT_FAILURES,
1443 	QDF_GET_MSG_BUFF_FAILURE,
1444 	QDF_ACTIVE_LIST_TIMEOUT,
1445 	QDF_SUSPEND_TIMEOUT,
1446 	QDF_RESUME_TIMEOUT,
1447 	QDF_WMI_EXCEED_MAX_PENDING_CMDS,
1448 	QDF_AP_STA_CONNECT_REQ_TIMEOUT,
1449 	QDF_STA_AP_CONNECT_REQ_TIMEOUT,
1450 	QDF_MAC_HW_MODE_CHANGE_TIMEOUT,
1451 	QDF_MAC_HW_MODE_CONFIG_TIMEOUT,
1452 	QDF_VDEV_START_RESPONSE_TIMED_OUT,
1453 	QDF_VDEV_RESTART_RESPONSE_TIMED_OUT,
1454 	QDF_VDEV_STOP_RESPONSE_TIMED_OUT,
1455 	QDF_VDEV_DELETE_RESPONSE_TIMED_OUT,
1456 	QDF_VDEV_PEER_DELETE_ALL_RESPONSE_TIMED_OUT,
1457 	QDF_WMI_BUF_SEQUENCE_MISMATCH,
1458 	QDF_HAL_REG_WRITE_FAILURE,
1459 	QDF_SUSPEND_NO_CREDIT,
1460 	QCA_HANG_BUS_FAILURE,
1461 	QDF_TASKLET_CREDIT_LATENCY_DETECT,
1462 	QDF_RX_REG_PKT_ROUTE_ERR,
1463 	QDF_VDEV_SM_OUT_OF_SYNC,
1464 	QDF_STATS_REQ_TIMEDOUT,
1465 	QDF_TX_DESC_LEAK,
1466 	QDF_RSO_STOP_RSP_TIMEOUT,
1467 };
1468 
1469 /**
1470  * enum qdf_stats_verbosity_level - Verbosity levels for stats
1471  * for which want to have different levels
1472  * @QDF_STATS_VERBOSITY_LEVEL_LOW: Stats verbosity level low
1473  * @QDF_STATS_VERBOSITY_LEVEL_HIGH: Stats verbosity level high
1474  */
1475 enum qdf_stats_verbosity_level {
1476 	QDF_STATS_VERBOSITY_LEVEL_LOW,
1477 	QDF_STATS_VERBOSITY_LEVEL_HIGH
1478 };
1479 
1480 /**
1481  * enum qdf_clock_id - The clock IDs of the various system clocks
1482  * @QDF_CLOCK_REALTIME: Clock is close to current time of day
1483  * @QDF_CLOCK_MONOTONIC: Clock is absolute elapsed time
1484  */
1485 enum qdf_clock_id {
1486 	QDF_CLOCK_REALTIME = __QDF_CLOCK_REALTIME,
1487 	QDF_CLOCK_MONOTONIC = __QDF_CLOCK_MONOTONIC
1488 };
1489 
1490 /**
1491  * enum qdf_hrtimer_mode - Mode arguments of qdf_hrtimer_data_t
1492  * related functions
1493  * @QDF_HRTIMER_MODE_ABS: Time value is absolute
1494  * @QDF_HRTIMER_MODE_REL: Time value is relative to now
1495  * @QDF_HRTIMER_MODE_PINNED: Timer is bound to CPU
1496  */
1497 enum qdf_hrtimer_mode {
1498 	QDF_HRTIMER_MODE_ABS = __QDF_HRTIMER_MODE_ABS,
1499 	QDF_HRTIMER_MODE_REL = __QDF_HRTIMER_MODE_REL,
1500 	QDF_HRTIMER_MODE_PINNED =  __QDF_HRTIMER_MODE_PINNED,
1501 };
1502 
1503 /**
1504  * enum qdf_hrtimer_restart_status - Return values for the
1505  * qdf_hrtimer_data_t callback function
1506  * @QDF_HRTIMER_NORESTART: Timer is not restarted
1507  * @QDF_HRTIMER_RESTART: Timer must be restarted
1508  */
1509 enum qdf_hrtimer_restart_status {
1510 	QDF_HRTIMER_NORESTART = __QDF_HRTIMER_NORESTART,
1511 	QDF_HRTIMER_RESTART = __QDF_HRTIMER_RESTART,
1512 };
1513 
1514 /**
1515  * enum qdf_context_mode - Values for the
1516  * hrtimer context
1517  * @QDF_CONTEXT_HARDWARE: Runs in hw interrupt context
1518  * @QDF_CONTEXT_TASKLET: Runs in tasklet context
1519  */
1520 enum qdf_context_mode {
1521 	QDF_CONTEXT_HARDWARE = 0,
1522 	QDF_CONTEXT_TASKLET = 1,
1523 };
1524 
1525 /**
1526  * enum qdf_dp_tx_rx_status - TX/RX packet status
1527  * @QDF_TX_RX_STATUS_INVALID: default invalid status
1528  * @QDF_TX_RX_STATUS_OK: successfully sent + acked
1529  * @QDF_TX_RX_STATUS_DISCARD: queued but not sent over air
1530  * @QDF_TX_RX_STATUS_NO_ACK: packet sent but no ack received
1531  * @QDF_TX_RX_STATUS_DROP: packet dropped due to congestion
1532  * @QDF_TX_RX_STATUS_DOWNLOAD_SUCC: packet delivered to target
1533  * @QDF_TX_RX_STATUS_DEFAULT: default status
1534  * @QDF_TX_RX_STATUS_MAX:
1535  */
1536 enum qdf_dp_tx_rx_status {
1537 	QDF_TX_RX_STATUS_INVALID,
1538 	QDF_TX_RX_STATUS_OK,
1539 	QDF_TX_RX_STATUS_FW_DISCARD,
1540 	QDF_TX_RX_STATUS_NO_ACK,
1541 	QDF_TX_RX_STATUS_DROP,
1542 	QDF_TX_RX_STATUS_DOWNLOAD_SUCC,
1543 	QDF_TX_RX_STATUS_DEFAULT,
1544 	QDF_TX_RX_STATUS_MAX
1545 };
1546 
1547 /**
1548  * enum qdf_pkt_type - TX/RX packet type
1549  * @QDF_TX_MGMT_PKT: Tx Management Packet
1550  * @QDF_TX_DATA_PKT: Tx data Packet
1551  * @QDF_RX_MGMT_PKT: Rx Management Packet
1552  * @QDF_RX_DATA_PKT: Rx data Packet
1553  * @QDF_INVALID_PKT: Invalid Packet type
1554  */
1555 enum qdf_pkt_type {
1556 	QDF_TX_MGMT_PKT,
1557 	QDF_TX_DATA_PKT,
1558 	QDF_RX_MGMT_PKT,
1559 	QDF_RX_DATA_PKT,
1560 	QDF_INVALID_PKT
1561 };
1562 
1563 /**
1564  * enum qdf_dp_a_status - A_STATUS
1565  * @QDF_A_STATUS_ERROR: Generic error return
1566  * @QDF_A_STATUS_OK: success
1567  */
1568 enum qdf_dp_a_status {
1569 	QDF_A_STATUS_ERROR = -1,
1570 	QDF_A_STATUS_OK,
1571 };
1572 
1573 /**
1574  * enum qdf_iommu_attr- qdf iommu domain attribute
1575  * @QDF_DOMAIN_ATTR_GEOMETRY: Domain attribute geometry
1576  * @QDF_DOMAIN_ATTR_PAGING: Domain attribute paging
1577  * @QDF_DOMAIN_ATTR_WINDOWS: Domain attribute windows
1578  * @QDF_DOMAIN_ATTR_FSL_PAMU_STASH: Domain attribute fsl pamu stash
1579  * @QDF_DOMAIN_ATTR_FSL_PAMU_ENABLE: Domain attribute fsl pamu enable
1580  * @QDF_DOMAIN_ATTR_FSL_PAMUV1: Domain attribute fsl pamu v1
1581  * @QDF_DOMAIN_ATTR_NESTING: Domain attribute Nesting
1582  * @QDF_DOMAIN_ATTR_DMA_USE_FLUSH_QUEUE: Domain attribute dma use flush queue
1583  * @QDF_DOMAIN_ATTR_PT_BASE_ADDR: Domain attribute pt base address
1584  * @QDF_DOMAIN_ATTR_CONTEXT_BANK: Domain attribute context bank
1585  * @QDF_DOMAIN_ATTR_DYNAMIC: Domain attribute dynamic
1586  * @QDF_DOMAIN_ATTR_TTBR0: Domain attribute TTBR0
1587  * @QDF_DOMAIN_ATTR_CONTEXTIDR: Domain attribute contextidr
1588  * @QDF_DOMAIN_ATTR_PROCID: Domain attribute procid
1589  * @QDF_DOMAIN_ATTR_NON_FATAL_FAULTS: Domain attribute non fatal faults
1590  * @QDF_DOMAIN_ATTR_S1_BYPASS: Domain attribute S1 bypass
1591  * @QDF_DOMAIN_ATTR_ATOMIC: Domain attribute atomic
1592  * @QDF_DOMAIN_ATTR_SECURE_VMID: Domain attribute secure cmid
1593  * @QDF_DOMAIN_ATTR_FAST: Domain attribute fast
1594  * @QDF_DOMAIN_ATTR_PGTBL_INFO: Domain attribute pgtbl info
1595  * @QDF_DOMAIN_ATTR_USE_UPSTREAM_HINT: Domain attribute use upsteram hint
1596  * @QDF_DOMAIN_ATTR_EARLY_MAP: Domain attribute early map
1597  * @QDF_DOMAIN_ATTR_PAGE_TABLE_IS_COHERENT: Domain attribute page table
1598  * is coherrent
1599  * @QDF_DOMAIN_ATTR_PAGE_TABLE_FORCE_COHERENT: Domain attribute page table
1600  * force coherrent
1601  * @QDF_DOMAIN_ATTR_USE_LLC_NWA: Domain attribute use llc nwa
1602  * @QDF_DOMAIN_ATTR_SPLIT_TABLES: Domain attribute split tables
1603  * @QDF_DOMAIN_ATTR_FAULT_MODEL_NO_CFRE: Domain attribute fault model no cfre
1604  * @QDF_DOMAIN_ATTR_FAULT_MODEL_NO_STALL: Domain attribute fault model no stall
1605  * @QDF_DOMAIN_ATTR_FAULT_MODEL_HUPCF: Domain attribute fault model hupcf
1606  * @QDF_DOMAIN_ATTR_MAX: Domain attribute max
1607  */
1608 enum qdf_iommu_attr {
1609 	QDF_DOMAIN_ATTR_GEOMETRY,
1610 	QDF_DOMAIN_ATTR_PAGING,
1611 	QDF_DOMAIN_ATTR_WINDOWS,
1612 	QDF_DOMAIN_ATTR_FSL_PAMU_STASH,
1613 	QDF_DOMAIN_ATTR_FSL_PAMU_ENABLE,
1614 	QDF_DOMAIN_ATTR_FSL_PAMUV1,
1615 	QDF_DOMAIN_ATTR_NESTING,
1616 	QDF_DOMAIN_ATTR_DMA_USE_FLUSH_QUEUE,
1617 	QDF_DOMAIN_ATTR_CONTEXT_BANK,
1618 	QDF_DOMAIN_ATTR_NON_FATAL_FAULTS,
1619 	QDF_DOMAIN_ATTR_S1_BYPASS,
1620 	QDF_DOMAIN_ATTR_ATOMIC,
1621 	QDF_DOMAIN_ATTR_SECURE_VMID,
1622 	QDF_DOMAIN_ATTR_FAST,
1623 	QDF_DOMAIN_ATTR_PGTBL_INFO,
1624 	QDF_DOMAIN_ATTR_USE_UPSTREAM_HINT,
1625 	QDF_DOMAIN_ATTR_EARLY_MAP,
1626 	QDF_DOMAIN_ATTR_PAGE_TABLE_IS_COHERENT,
1627 	QDF_DOMAIN_ATTR_PAGE_TABLE_FORCE_COHERENT,
1628 	QDF_DOMAIN_ATTR_USE_LLC_NWA,
1629 	QDF_DOMAIN_ATTR_SPLIT_TABLES,
1630 	QDF_DOMAIN_ATTR_FAULT_MODEL_NO_CFRE,
1631 	QDF_DOMAIN_ATTR_FAULT_MODEL_NO_STALL,
1632 	QDF_DOMAIN_ATTR_FAULT_MODEL_HUPCF,
1633 	QDF_DOMAIN_ATTR_MAX,
1634 };
1635 
1636 #endif /* __QDF_TYPES_H */
1637