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