xref: /wlan-dirver/qca-wifi-host-cmn/qdf/inc/qdf_types.h (revision 27d564647e9b50e713c60b0d7e5ea2a9b0a3ae74) !
1 /*
2  * Copyright (c) 2014-2018 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 #ifndef CONFIG_MCL
28 #if !defined(__printf)
29 #define __printf(a, b)
30 #endif
31 #endif
32 
33 
34 /* Include Files */
35 #include <i_qdf_types.h>
36 #include <stdarg.h>
37 #ifdef TSOSEG_DEBUG
38 #include <qdf_atomic.h>
39 #endif
40 
41 /* Preprocessor definitions and constants */
42 #define QDF_MAX_SGLIST 4
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_device_t - Platform/bus generic handle.
113  * Used for bus specific functions.
114  */
115 typedef __qdf_device_t qdf_device_t;
116 
117 /* Byte order identifiers */
118 typedef __qdf_le16_t qdf_le16_t;
119 typedef __qdf_le32_t qdf_le32_t;
120 typedef __qdf_le64_t qdf_le64_t;
121 typedef __qdf_be16_t qdf_be16_t;
122 typedef __qdf_be32_t qdf_be32_t;
123 typedef __qdf_be64_t qdf_be64_t;
124 
125 /**
126  * typedef qdf_size_t - size of an object
127  */
128 typedef __qdf_size_t qdf_size_t;
129 
130 /**
131  * typedef __qdf_off_t - offset for API's that need them.
132  */
133 typedef __qdf_off_t      qdf_off_t;
134 
135 /**
136  * typedef qdf_dma_map_t - DMA mapping object.
137  */
138 typedef __qdf_dma_map_t qdf_dma_map_t;
139 
140 /**
141  * tyepdef qdf_dma_addr_t - DMA address.
142  */
143 typedef __qdf_dma_addr_t qdf_dma_addr_t;
144 
145 /**
146  * typedef __qdf_dma_size_t - DMA size.
147  */
148 typedef __qdf_dma_size_t     qdf_dma_size_t;
149 
150 /**
151  * tyepdef qdf_dma_context_t - DMA context.
152  */
153 typedef __qdf_dma_context_t qdf_dma_context_t;
154 
155 typedef __qdf_mem_info_t qdf_mem_info_t;
156 typedef __sgtable_t sgtable_t;
157 
158 /**
159  * pointer to net device
160  */
161 typedef __qdf_netdev_t qdf_netdev_t;
162 
163 /**
164  * struct qdf_dma_map_info - Information inside a DMA map.
165  * @nsegs: total number mapped segments
166  * struct __dma_segs - Information of physical address.
167  * @paddr: physical(dam'able) address of the segment
168  * @len: length of the segment
169  */
170 typedef struct qdf_dma_map_info {
171 	uint32_t nsegs;
172 	struct __dma_segs {
173 		qdf_dma_addr_t paddr;
174 		qdf_dma_size_t len;
175 	} dma_segs[QDF_MAX_SCATTER];
176 } qdf_dmamap_info_t;
177 
178 /**
179  * struct qdf_shared_mem - Shared memory resource
180  * @mem_info: memory info struct
181  * @vaddr: virtual address
182  * @sgtable: scatter-gather table
183  * @memctx: dma address
184  */
185 typedef struct qdf_shared_mem {
186 	qdf_mem_info_t mem_info;
187 	void *vaddr;
188 	sgtable_t sgtable;
189 	qdf_dma_mem_context(memctx);
190 } qdf_shared_mem_t;
191 
192 #define qdf_iomem_t __qdf_iomem_t;
193 
194 /**
195  * typedef enum QDF_TIMER_TYPE - QDF timer type
196  * @QDF_TIMER_TYPE_SW: Deferrable SW timer it will not cause CPU to wake up
197  * on expiry
198  * @QDF_TIMER_TYPE_WAKE_APPS: Non deferrable timer which will cause CPU to
199  * wake up on expiry
200  */
201 typedef enum {
202 	QDF_TIMER_TYPE_SW,
203 	QDF_TIMER_TYPE_WAKE_APPS
204 } QDF_TIMER_TYPE;
205 
206 /**
207  * tyepdef qdf_resource_type_t - hw resources
208  * @QDF_RESOURCE_TYPE_MEM: memory resource
209  * @QDF_RESOURCE_TYPE_IO: io resource
210  * Define the hw resources the OS has allocated for the device
211  * Note that start defines a mapped area.
212  */
213 typedef enum {
214 	QDF_RESOURCE_TYPE_MEM,
215 	QDF_RESOURCE_TYPE_IO,
216 } qdf_resource_type_t;
217 
218 /**
219  * tyepdef qdf_resource_t - representation of a h/w resource.
220  * @start: start
221  * @end: end
222  * @type: resource type
223  */
224 typedef struct {
225 	uint64_t start;
226 	uint64_t end;
227 	qdf_resource_type_t type;
228 } qdf_resource_t;
229 
230 /**
231  * typedef qdf_dma_dir_t - DMA directions
232  * @QDF_DMA_BIDIRECTIONAL: bidirectional data
233  * @QDF_DMA_TO_DEVICE: data going from device to memory
234  * @QDF_DMA_FROM_DEVICE: data going from memory to device
235  */
236 typedef enum {
237 	QDF_DMA_BIDIRECTIONAL = __QDF_DMA_BIDIRECTIONAL,
238 	QDF_DMA_TO_DEVICE = __QDF_DMA_TO_DEVICE,
239 	QDF_DMA_FROM_DEVICE = __QDF_DMA_FROM_DEVICE,
240 } qdf_dma_dir_t;
241 
242 /**
243  * enum qdf_driver_type - Indicate the driver type and based on this
244  * do appropriate initialization.
245  *
246  * @QDF_DRIVER_TYPE_PRODUCTION: Driver used in the production
247  * @QDF_DRIVER_TYPE_MFG: Driver used in the Factory
248  * @QDF_DRIVER_TYPE_INVALID: Invalid and unrecognized type
249  *
250  */
251 enum qdf_driver_type {
252 	QDF_DRIVER_TYPE_PRODUCTION = 0,
253 	QDF_DRIVER_TYPE_MFG = 1,
254 	QDF_DRIVER_TYPE_INVALID = 0x7FFFFFFF
255 };
256 
257 /* work queue(kernel thread)/DPC function callback */
258 typedef void (*qdf_defer_fn_t)(void *);
259 
260 /*
261  * Prototype of the critical region function that is to be
262  * executed with spinlock held and interrupt disalbed
263  */
264 typedef bool (*qdf_irqlocked_func_t)(void *);
265 
266 /* Prototype of timer function */
267 typedef void (*qdf_timer_func_t)(void *);
268 
269 #define qdf_offsetof(type, field) offsetof(type, field)
270 
271 /**
272  * typedef enum QDF_MODULE_ID  - Debug category level
273  * @QDF_MODULE_ID_TDLS: TDLS
274  * @QDF_MODULE_ID_ACS: auto channel selection
275  * @QDF_MODULE_ID_SCAN_SM: scan state machine
276  * @QDF_MODULE_ID_SCANENTRY: scan entry
277  * @QDF_MODULE_ID_WDS: WDS handling
278  * @QDF_MODULE_ID_ACTION: action management frames
279  * @QDF_MODULE_ID_ROAM: sta mode roaming
280  * @QDF_MODULE_ID_INACT: inactivity handling
281  * @QDF_MODULE_ID_DOTH: 11.h
282  * @QDF_MODULE_ID_IQUE: IQUE features
283  * @QDF_MODULE_ID_WME: WME protocol
284  * @QDF_MODULE_ID_ACL: ACL handling
285  * @QDF_MODULE_ID_WPA: WPA/RSN protocol
286  * @QDF_MODULE_ID_RADKEYS: dump 802.1x keys
287  * @QDF_MODULE_ID_RADDUMP: dump 802.1x radius packets
288  * @QDF_MODULE_ID_RADIUS: 802.1x radius client
289  * @QDF_MODULE_ID_DOT1XSM: 802.1x state machine
290  * @QDF_MODULE_ID_DOT1X: 802.1x authenticator
291  * @QDF_MODULE_ID_POWER: power save handling
292  * @QDF_MODULE_ID_STATS: state machine
293  * @QDF_MODULE_ID_OUTPUT: output handling
294  * @QDF_MODULE_ID_SCAN: scanning
295  * @QDF_MODULE_ID_AUTH: authentication handling
296  * @QDF_MODULE_ID_ASSOC: association handling
297  * @QDF_MODULE_ID_NODE: node handling
298  * @QDF_MODULE_ID_ELEMID: element id parsing
299  * @QDF_MODULE_ID_XRATE: rate set handling
300  * @QDF_MODULE_ID_INPUT: input handling
301  * @QDF_MODULE_ID_CRYPTO: crypto work
302  * @QDF_MODULE_ID_DUMPPKTS: IFF_LINK2 equivalant
303  * @QDF_MODULE_ID_DEBUG: IFF_DEBUG equivalent
304  * @QDF_MODULE_ID_MLME: MLME
305  * @QDF_MODULE_ID_RRM: Radio resource measurement
306  * @QDF_MODULE_ID_WNM: Wireless Network Management
307  * @QDF_MODULE_ID_P2P_PROT: P2P Protocol driver
308  * @QDF_MODULE_ID_PROXYARP: 11v Proxy ARP
309  * @QDF_MODULE_ID_L2TIF: Hotspot 2.0 L2 TIF
310  * @QDF_MODULE_ID_WIFIPOS: WifiPositioning Feature
311  * @QDF_MODULE_ID_WRAP: WRAP or Wireless ProxySTA
312  * @QDF_MODULE_ID_DFS: DFS debug mesg
313  * @QDF_MODULE_ID_TLSHIM: TLSHIM module ID
314  * @QDF_MODULE_ID_WMI: WMI module ID
315  * @QDF_MODULE_ID_HTT: HTT module ID
316  * @QDF_MODULE_ID_HDD: HDD module ID
317  * @QDF_MODULE_ID_SME: SME module ID
318  * @QDF_MODULE_ID_PE: PE module ID
319  * @QDF_MODULE_ID_WMA: WMA module ID
320  * @QDF_MODULE_ID_SYS: SYS module ID
321  * @QDF_MODULE_ID_QDF: QDF module ID
322  * @QDF_MODULE_ID_SAP: SAP module ID
323  * @QDF_MODULE_ID_HDD_SOFTAP: HDD SAP module ID
324  * @QDF_MODULE_ID_HDD_DATA: HDD DATA module ID
325  * @QDF_MODULE_ID_HDD_SAP_DATA: HDD SAP DATA module ID
326  * @QDF_MODULE_ID_HIF: HIF module ID
327  * @QDF_MODULE_ID_HTC: HTC module ID
328  * @QDF_MODULE_ID_TXRX: TXRX module ID
329  * @QDF_MODULE_ID_QDF_DEVICE: QDF DEVICE module ID
330  * @QDF_MODULE_ID_CFG: CFG module ID
331  * @QDF_MODULE_ID_BMI: BMI module ID
332  * @QDF_MODULE_ID_EPPING: EPPING module ID
333  * @QDF_MODULE_ID_QVIT: QVIT module ID
334  * @QDF_MODULE_ID_DP: Data-path module ID
335  * @QDF_MODULE_ID_SOC: SOC module ID
336  * @QDF_MODULE_ID_OS_IF: OS-interface module ID
337  * @QDF_MODULE_ID_TARGET_IF: targer interface module ID
338  * @QDF_MODULE_ID_SCHEDULER: schduler module ID
339  * @QDF_MODULE_ID_MGMT_TXRX: management TX/RX module ID
340  * @QDF_MODULE_ID_SERIALIZATION: serialization module ID
341  * @QDF_MODULE_ID_PMO: PMO (power manager and offloads) Module ID
342  * @QDF_MODULE_ID_P2P: P2P module ID
343  * @QDF_MODULE_ID_POLICY_MGR: Policy Manager module ID
344  * @QDF_MODULE_ID_CONFIG: CFG (configuration) component ID
345  * @QDF_MODULE_ID_REGULATORY: REGULATORY module ID
346  * @QDF_MODULE_ID_NAN: NAN module ID
347  * @QDF_MODULE_ID_SPECTRAL: Spectral module ID
348  * @QDF_MODULE_ID_ROAM_DEBUG: Roam Debug logging
349  * @QDF_MODULE_ID_CDP: Converged Data Path module ID
350  * @QDF_MODULE_ID_DIRECT_BUF_RX: Direct Buffer Receive module ID
351  * @QDF_MODULE_ID_DISA: DISA (encryption test) module ID
352  * @QDF_MODULE_ID_GREEN_AP: Green AP related logging
353  * @QDF_MODULE_ID_FTM: FTM module ID
354  * @QDF_MODULE_ID_EXTAP: Extender AP module ID
355  * @QDF_MODULE_ID_FD: FILS discovery logging
356  * @QDF_MODULE_ID_OCB: OCB module ID
357  * @QDF_MODULE_ID_IPA: IPA module ID
358  * @QDF_MODULE_ID_CP_STATS: Control Plane Statistics ID
359  * @QDF_MODULE_ID_ACTION_OUI: ACTION OUI module ID
360  * @QDF_MODULE_ID_TARGET: Target module ID
361  * @QDF_MODULE_ID_MBSSIE: MBSS IE ID
362  * @QDF_MODULE_ID_FWOL: FW Offload module ID
363  * @QDF_MODULE_ID_SM_ENGINE: SM engine module ID
364  * @QDF_MODULE_ID_CMN_MLME: CMN MLME module ID
365  * @QDF_MODULE_ID_ANY: anything
366  * @QDF_MODULE_ID_MAX: Max place holder module ID
367  */
368 typedef enum {
369 	QDF_MODULE_ID_TDLS      = 0,
370 	QDF_MODULE_ID_ACS,
371 	QDF_MODULE_ID_SCAN_SM,
372 	QDF_MODULE_ID_SCANENTRY,
373 	QDF_MODULE_ID_WDS,
374 	QDF_MODULE_ID_ACTION,
375 	QDF_MODULE_ID_ROAM,
376 	QDF_MODULE_ID_INACT,
377 	QDF_MODULE_ID_DOTH      = 8,
378 	QDF_MODULE_ID_IQUE,
379 	QDF_MODULE_ID_WME,
380 	QDF_MODULE_ID_ACL,
381 	QDF_MODULE_ID_WPA,
382 	QDF_MODULE_ID_RADKEYS,
383 	QDF_MODULE_ID_RADDUMP,
384 	QDF_MODULE_ID_RADIUS,
385 	QDF_MODULE_ID_DOT1XSM   = 16,
386 	QDF_MODULE_ID_DOT1X,
387 	QDF_MODULE_ID_POWER,
388 	QDF_MODULE_ID_STATE,
389 	QDF_MODULE_ID_OUTPUT,
390 	QDF_MODULE_ID_SCAN,
391 	QDF_MODULE_ID_AUTH,
392 	QDF_MODULE_ID_ASSOC,
393 	QDF_MODULE_ID_NODE      = 24,
394 	QDF_MODULE_ID_ELEMID,
395 	QDF_MODULE_ID_XRATE,
396 	QDF_MODULE_ID_INPUT,
397 	QDF_MODULE_ID_CRYPTO,
398 	QDF_MODULE_ID_DUMPPKTS,
399 	QDF_MODULE_ID_DEBUG,
400 	QDF_MODULE_ID_MLME,
401 	QDF_MODULE_ID_RRM       = 32,
402 	QDF_MODULE_ID_WNM,
403 	QDF_MODULE_ID_P2P_PROT,
404 	QDF_MODULE_ID_PROXYARP,
405 	QDF_MODULE_ID_L2TIF,
406 	QDF_MODULE_ID_WIFIPOS,
407 	QDF_MODULE_ID_WRAP,
408 	QDF_MODULE_ID_DFS,
409 	QDF_MODULE_ID_ATF       = 40,
410 	QDF_MODULE_ID_SPLITMAC,
411 	QDF_MODULE_ID_IOCTL,
412 	QDF_MODULE_ID_NAC,
413 	QDF_MODULE_ID_MESH,
414 	QDF_MODULE_ID_MBO,
415 	QDF_MODULE_ID_EXTIOCTL_CHANSWITCH,
416 	QDF_MODULE_ID_EXTIOCTL_CHANSSCAN,
417 	QDF_MODULE_ID_TLSHIM    = 48,
418 	QDF_MODULE_ID_WMI,
419 	QDF_MODULE_ID_HTT,
420 	QDF_MODULE_ID_HDD,
421 	QDF_MODULE_ID_SME,
422 	QDF_MODULE_ID_PE,
423 	QDF_MODULE_ID_WMA,
424 	QDF_MODULE_ID_SYS,
425 	QDF_MODULE_ID_QDF       = 56,
426 	QDF_MODULE_ID_SAP,
427 	QDF_MODULE_ID_HDD_SOFTAP,
428 	QDF_MODULE_ID_HDD_DATA,
429 	QDF_MODULE_ID_HDD_SAP_DATA,
430 	QDF_MODULE_ID_HIF,
431 	QDF_MODULE_ID_HTC,
432 	QDF_MODULE_ID_TXRX,
433 	QDF_MODULE_ID_QDF_DEVICE = 64,
434 	QDF_MODULE_ID_CFG,
435 	QDF_MODULE_ID_BMI,
436 	QDF_MODULE_ID_EPPING,
437 	QDF_MODULE_ID_QVIT,
438 	QDF_MODULE_ID_DP,
439 	QDF_MODULE_ID_SOC,
440 	QDF_MODULE_ID_OS_IF,
441 	QDF_MODULE_ID_TARGET_IF,
442 	QDF_MODULE_ID_SCHEDULER,
443 	QDF_MODULE_ID_MGMT_TXRX,
444 	QDF_MODULE_ID_SERIALIZATION,
445 	QDF_MODULE_ID_PMO,
446 	QDF_MODULE_ID_P2P,
447 	QDF_MODULE_ID_POLICY_MGR,
448 	QDF_MODULE_ID_CONFIG,
449 	QDF_MODULE_ID_REGULATORY,
450 	QDF_MODULE_ID_SA_API,
451 	QDF_MODULE_ID_NAN,
452 	QDF_MODULE_ID_OFFCHAN_TXRX,
453 	QDF_MODULE_ID_SON,
454 	QDF_MODULE_ID_SPECTRAL,
455 	QDF_MODULE_ID_OBJ_MGR,
456 	QDF_MODULE_ID_NSS,
457 	QDF_MODULE_ID_ROAM_DEBUG,
458 	QDF_MODULE_ID_CDP,
459 	QDF_MODULE_ID_DIRECT_BUF_RX,
460 	QDF_MODULE_ID_DISA,
461 	QDF_MODULE_ID_GREEN_AP,
462 	QDF_MODULE_ID_FTM,
463 	QDF_MODULE_ID_EXTAP,
464 	QDF_MODULE_ID_FD,
465 	QDF_MODULE_ID_OCB,
466 	QDF_MODULE_ID_IPA,
467 	QDF_MODULE_ID_CP_STATS,
468 	QDF_MODULE_ID_ACTION_OUI,
469 	QDF_MODULE_ID_TARGET,
470 	QDF_MODULE_ID_MBSSIE,
471 	QDF_MODULE_ID_FWOL,
472 	QDF_MODULE_ID_SM_ENGINE,
473 	QDF_MODULE_ID_CMN_MLME,
474 	QDF_MODULE_ID_BSSCOLOR,
475 	QDF_MODULE_ID_ANY,
476 	QDF_MODULE_ID_MAX,
477 } QDF_MODULE_ID;
478 
479 /**
480  * typedef enum QDF_TRACE_LEVEL - Debug verbose level
481  * @QDF_TRACE_LEVEL_NONE: no trace will be logged. This value is in place
482  *			  for the qdf_trace_setlevel() to allow the user
483  *			  to turn off all traces
484  * @QDF_TRACE_LEVEL_FATAL: Indicates fatal error conditions
485  * @QDF_TRACE_LEVEL_ERROR: Indicates error conditions
486  * @QDF_TRACE_LEVEL_WARN: May indicate that an error will occur if action
487  *			  is not taken
488  * @QDF_TRACE_LEVEL_INFO: Normal operational messages that require no action
489  * @QDF_TRACE_LEVEL_INFO_HIGH: High level operational messages that require
490  *			       no action
491  * @QDF_TRACE_LEVEL_INFO_MED: Middle level operational messages that require
492  *			      no action
493  * @QDF_TRACE_LEVEL_INFO_LOW: Low level operational messages that require
494  *			      no action
495  * @QDF_TRACE_LEVEL_DEBUG: Information useful to developers for debugging
496  * @QDF_TRACE_LEVEL_TRACE: Indicates trace level for automation scripts,
497  *			whenever there is a context switch in driver, one
498  *			print using this trace level will be added with
499  *			the help of qdf_trace api.
500  * @QDF_TRACE_LEVEL_ALL: All trace levels
501  * @QDF_TRACE_LEVEL_MAX: Max trace level
502  */
503 typedef enum {
504 	QDF_TRACE_LEVEL_NONE,
505 	QDF_TRACE_LEVEL_FATAL,
506 	QDF_TRACE_LEVEL_ERROR,
507 	QDF_TRACE_LEVEL_WARN,
508 	QDF_TRACE_LEVEL_INFO,
509 	QDF_TRACE_LEVEL_INFO_HIGH,
510 	QDF_TRACE_LEVEL_INFO_MED,
511 	QDF_TRACE_LEVEL_INFO_LOW,
512 	QDF_TRACE_LEVEL_DEBUG,
513 	QDF_TRACE_LEVEL_TRACE,
514 	QDF_TRACE_LEVEL_ALL,
515 	QDF_TRACE_LEVEL_MAX
516 } QDF_TRACE_LEVEL;
517 
518 /**
519  * enum QDF_OPMODE - vdev operating mode
520  * @QDF_STA_MODE: STA mode
521  * @QDF_SAP_MODE: SAP mode
522  * @QDF_P2P_CLIENT_MODE: P2P client mode
523  * @QDF_P2P_GO_MODE: P2P GO mode
524  * @QDF_FTM_MODE: FTM mode
525  * @QDF_IBSS_MODE: IBSS mode
526  * @QDF_MONITOR_MODE: Monitor mode
527  * @QDF_P2P_DEVICE_MODE: P2P device mode
528  * @QDF_OCB_MODE: OCB device mode
529  * @QDF_EPPING_MODE: EPPING device mode
530  * @QDF_QVIT_MODE: QVIT device mode
531  * @QDF_NDI_MODE: NAN datapath mode
532  * @QDF_WDS_MODE: WDS mode
533  * @QDF_BTAMP_MODE: BTAMP mode
534  * @QDF_AHDEMO_MODE: AHDEMO mode
535  * @QDF_MAX_NO_OF_MODE: Max place holder
536  *
537  * These are generic IDs that identify the various roles
538  * in the software system
539  */
540 enum QDF_OPMODE {
541 	QDF_STA_MODE,
542 	QDF_SAP_MODE,
543 	QDF_P2P_CLIENT_MODE,
544 	QDF_P2P_GO_MODE,
545 	QDF_FTM_MODE,
546 	QDF_IBSS_MODE,
547 	QDF_MONITOR_MODE,
548 	QDF_P2P_DEVICE_MODE,
549 	QDF_OCB_MODE,
550 	QDF_EPPING_MODE,
551 	QDF_QVIT_MODE,
552 	QDF_NDI_MODE,
553 	QDF_WDS_MODE,
554 	QDF_BTAMP_MODE,
555 	QDF_AHDEMO_MODE,
556 	QDF_MAX_NO_OF_MODE
557 };
558 
559 /**
560  * enum QDF_GLOBAL_MODE - global mode when driver is loaded.
561  *
562  * @QDF_GLOBAL_MISSION_MODE: mission mode (STA, SAP...)
563  * @QDF_GLOBAL_MONITOR_MODE: Monitor Mode
564  * @QDF_GLOBAL_FTM_MODE: FTM mode
565  * @QDF_GLOBAL_IBSS_MODE: IBSS mode
566  * @QDF_GLOBAL_EPPING_MODE: EPPING mode
567  * @QDF_GLOBAL_QVIT_MODE: QVIT global mode
568  * @QDF_GLOBAL_MAX_MODE: Max place holder
569  */
570 enum QDF_GLOBAL_MODE {
571 	QDF_GLOBAL_MISSION_MODE,
572 	QDF_GLOBAL_WALTEST_MODE = 3,
573 	QDF_GLOBAL_MONITOR_MODE = 4,
574 	QDF_GLOBAL_FTM_MODE = 5,
575 	QDF_GLOBAL_IBSS_MODE = 6,
576 	QDF_GLOBAL_COLDBOOT_CALIB_MODE = 7,
577 	QDF_GLOBAL_EPPING_MODE = 8,
578 	QDF_GLOBAL_QVIT_MODE = 9,
579 	QDF_GLOBAL_MAX_MODE
580 };
581 
582 #define  QDF_IS_EPPING_ENABLED(mode) (mode == QDF_GLOBAL_EPPING_MODE)
583 
584 /**
585  * qdf_trace_msg()- logging API
586  * @module: Module identifier. A member of the QDF_MODULE_ID enumeration that
587  *	    identifies the module issuing the trace message.
588  * @level: Trace level. A member of the QDF_TRACE_LEVEL enumeration indicating
589  *	   the severity of the condition causing the trace message to be issued.
590  *	   More severe conditions are more likely to be logged.
591  * @str_format: Format string. The message to be logged. This format string
592  *	       contains printf-like replacement parameters, which follow this
593  *	       parameter in the variable argument list.
594  *
595  * Users wishing to add tracing information to their code should use
596  * QDF_TRACE.  QDF_TRACE() will compile into a call to qdf_trace_msg() when
597  * tracing is enabled.
598  *
599  * Return: nothing
600  *
601  * implemented in qdf_trace.c
602  */
603 void __printf(3, 4) qdf_trace_msg(QDF_MODULE_ID module, QDF_TRACE_LEVEL level,
604 		   char *str_format, ...);
605 /**
606  * qdf_vtrace_msg() - the va_list version of qdf_trace_msg
607  * @module: the calling module's Id
608  * @level: the logging level to log using
609  * @str_format: the log format string
610  * @val: the va_list containing the values to format according to str_format
611  *
612  * Return: None
613  */
614 void qdf_vtrace_msg(QDF_MODULE_ID module, QDF_TRACE_LEVEL level,
615 		    char *str_format, va_list val);
616 
617 #ifdef CONFIG_MCL
618 
619 #define qdf_print(params...) QDF_TRACE_ERROR(QDF_MODULE_ID_QDF, ## params)
620 #define qdf_alert(params...) QDF_TRACE_FATAL(QDF_MODULE_ID_QDF, ## params)
621 #define qdf_err(params...) QDF_TRACE_ERROR(QDF_MODULE_ID_QDF, ## params)
622 #define qdf_warn(params...) QDF_TRACE_WARN(QDF_MODULE_ID_QDF, ## params)
623 #define qdf_info(params...) QDF_TRACE_INFO(QDF_MODULE_ID_QDF, ## params)
624 #define qdf_debug(params...) QDF_TRACE_DEBUG(QDF_MODULE_ID_QDF, ## params)
625 
626 #else /* CONFIG_MCL */
627 
628 #define qdf_print(args...) QDF_TRACE_INFO(QDF_MODULE_ID_ANY, ## args)
629 #define qdf_alert(args...) QDF_TRACE_FATAL(QDF_MODULE_ID_ANY, ## args)
630 #define qdf_err(args...)   QDF_TRACE_ERROR(QDF_MODULE_ID_ANY, ## args)
631 #define qdf_warn(args...)  QDF_TRACE_WARN(QDF_MODULE_ID_ANY, ## args)
632 #define qdf_info(args...)  QDF_TRACE_INFO(QDF_MODULE_ID_ANY, ## args)
633 #define qdf_debug(args...) QDF_TRACE_DEBUG(QDF_MODULE_ID_ANY, ## args)
634 
635 #endif /* CONFIG_MCL */
636 
637 #define qdf_nofl_alert(params...) \
638 	QDF_TRACE_FATAL_NO_FL(QDF_MODULE_ID_QDF, ## params)
639 #define qdf_nofl_err(params...) \
640 	QDF_TRACE_ERROR_NO_FL(QDF_MODULE_ID_QDF, ## params)
641 #define qdf_nofl_warn(params...) \
642 	QDF_TRACE_WARN_NO_FL(QDF_MODULE_ID_QDF, ## params)
643 #define qdf_nofl_info(params...) \
644 	QDF_TRACE_INFO_NO_FL(QDF_MODULE_ID_QDF, ## params)
645 #define qdf_nofl_debug(params...) \
646 	QDF_TRACE_DEBUG_NO_FL(QDF_MODULE_ID_QDF, ## params)
647 
648 #define qdf_rl_alert(params...) QDF_TRACE_FATAL_RL(QDF_MODULE_ID_QDF, ## params)
649 #define qdf_rl_err(params...) QDF_TRACE_ERROR_RL(QDF_MODULE_ID_QDF, ## params)
650 #define qdf_rl_warn(params...) QDF_TRACE_WARN_RL(QDF_MODULE_ID_QDF, ## params)
651 #define qdf_rl_info(params...) QDF_TRACE_INFO_RL(QDF_MODULE_ID_QDF, ## params)
652 #define qdf_rl_debug(params...) QDF_TRACE_DEBUG_RL(QDF_MODULE_ID_QDF, ## params)
653 
654 #define qdf_rl_nofl_alert(params...) \
655 	QDF_TRACE_FATAL_RL_NO_FL(QDF_MODULE_ID_QDF, ## params)
656 #define qdf_rl_nofl_err(params...) \
657 	QDF_TRACE_ERROR_RL_NO_FL(QDF_MODULE_ID_QDF, ## params)
658 #define qdf_rl_nofl_warn(params...) \
659 	QDF_TRACE_WARN_RL_NO_FL(QDF_MODULE_ID_QDF, ## params)
660 #define qdf_rl_nofl_info(params...) \
661 	QDF_TRACE_INFO_RL_NO_FL(QDF_MODULE_ID_QDF, ## params)
662 #define qdf_rl_nofl_debug(params...) \
663 	QDF_TRACE_DEBUG_RL_NO_FL(QDF_MODULE_ID_QDF, ## params)
664 
665 #define qdf_vprint    __qdf_vprint
666 #define qdf_snprint   __qdf_snprint
667 
668 #define qdf_kstrtoint __qdf_kstrtoint
669 #define qdf_kstrtouint __qdf_kstrtouint
670 
671 #ifdef WLAN_OPEN_P2P_INTERFACE
672 /* This should match with WLAN_MAX_INTERFACES */
673 #define QDF_MAX_CONCURRENCY_PERSONA  (4)
674 #else
675 #define QDF_MAX_CONCURRENCY_PERSONA  (3)
676 #endif
677 
678 #define QDF_STA_MASK (1 << QDF_STA_MODE)
679 #define QDF_SAP_MASK (1 << QDF_SAP_MODE)
680 #define QDF_P2P_CLIENT_MASK (1 << QDF_P2P_CLIENT_MODE)
681 #define QDF_P2P_GO_MASK (1 << QDF_P2P_GO_MODE)
682 
683 #ifdef FEATURE_WLAN_MCC_TO_SCC_SWITCH
684 
685 /**
686  * typedef tQDF_MCC_TO_SCC_SWITCH_MODE - MCC to SCC switch mode.
687  * @QDF_MCC_TO_SCC_SWITCH_DISABLE: Disable switch
688  * @QDF_MCC_TO_SCC_SWITCH_ENABLE: Enable switch
689  * @QDF_MCC_TO_SCC_SWITCH_FORCE: Force switch with SAP restart
690  * @QDF_MCC_TO_SCC_SWITCH_FORCE_WITHOUT_DISCONNECTION: Force switch without
691  * restart of SAP
692  * @QDF_MCC_TO_SCC_SWITCH_WITH_FAVORITE_CHANNEL: Switch using fav channel(s)
693  * without SAP restart
694  * @QDF_MCC_TO_SCC_SWITCH_FORCE_PREFERRED_WITHOUT_DISCONNECTION: Force switch
695  * without SAP restart. MCC is allowed only in below exception cases:
696  *	Exception Case-1: When STA is operating on DFS channel.
697  *	Exception Case-2: When STA is operating on LTE-CoEx channel.
698  *	Exception Case-3: When STA is operating on AP disabled channel.
699  * @QDF_MCC_TO_SCC_WITH_PREFERRED_BAND: Force SCC only in user preferred band.
700  * Allow MCC if STA is operating or comes up on other than user preferred band.
701  *
702  * @QDF_MCC_TO_SCC_SWITCH_MAX: max switch
703  */
704 typedef enum {
705 	QDF_MCC_TO_SCC_SWITCH_DISABLE = 0,
706 	QDF_MCC_TO_SCC_SWITCH_ENABLE,
707 	QDF_MCC_TO_SCC_SWITCH_FORCE,
708 	QDF_MCC_TO_SCC_SWITCH_FORCE_WITHOUT_DISCONNECTION,
709 	QDF_MCC_TO_SCC_SWITCH_WITH_FAVORITE_CHANNEL,
710 	QDF_MCC_TO_SCC_SWITCH_FORCE_PREFERRED_WITHOUT_DISCONNECTION,
711 	QDF_MCC_TO_SCC_WITH_PREFERRED_BAND,
712 	QDF_MCC_TO_SCC_SWITCH_MAX
713 } tQDF_MCC_TO_SCC_SWITCH_MODE;
714 #endif
715 
716 #if !defined(NULL)
717 #ifdef __cplusplus
718 #define NULL   0
719 #else
720 #define NULL   ((void *)0)
721 #endif
722 #endif
723 
724 /**
725  * qdf_bool_parse() - parse the given string as a boolean value
726  * @bool_str: the input boolean string to parse
727  * @out_bool: the output boolean value, populated on success
728  *
729  * 1, y, Y are mapped to true, 0, n, N are mapped to false.
730  * Leading/trailing whitespace is ignored.
731  *
732  * Return: QDF_STATUS
733  */
734 QDF_STATUS qdf_bool_parse(const char *bool_str, bool *out_bool);
735 
736 /**
737  * qdf_int32_parse() - parse the given string as a 32-bit signed integer
738  * @int_str: the input integer string to parse
739  * @out_int: the output integer value, populated on success
740  *
741  * Supports binary (0b), octal (0o), decimal (no prefix), and hexadecimal (0x)
742  * encodings via typical prefix notation. Leading/trailing whitespace is
743  * ignored.
744  *
745  * Return: QDF_STATUS
746  */
747 QDF_STATUS qdf_int32_parse(const char *int_str, int32_t *out_int);
748 
749 /**
750  * qdf_uint32_parse() - parse the given string as a 32-bit unsigned integer
751  * @int_str: the input integer string to parse
752  * @out_int: the output integer value, populated on success
753  *
754  * Supports binary (0b), octal (0o), decimal (no prefix), and hexadecimal (0x)
755  * encodings via typical prefix notation. Leading/trailing whitespace is
756  * ignored.
757  *
758  * Return: QDF_STATUS
759  */
760 QDF_STATUS qdf_uint32_parse(const char *int_str, uint32_t *out_int);
761 
762 /**
763  * qdf_int64_parse() - parse the given string as a 64-bit signed integer
764  * @int_str: the input integer string to parse
765  * @out_int: the output integer value, populated on success
766  *
767  * Supports binary (0b), octal (0o), decimal (no prefix), and hexadecimal (0x)
768  * encodings via typical prefix notation. Leading/trailing whitespace is
769  * ignored.
770  *
771  * Return: QDF_STATUS
772  */
773 QDF_STATUS qdf_int64_parse(const char *int_str, int64_t *out_int);
774 
775 /**
776  * qdf_uint64_parse() - parse the given string as a 64-bit unsigned integer
777  * @int_str: the input integer string to parse
778  * @out_int: the output integer value, populated on success
779  *
780  * Supports binary (0b), octal (0o), decimal (no prefix), and hexadecimal (0x)
781  * encodings via typical prefix notation. Leading/trailing whitespace is
782  * ignored.
783  *
784  * Return: QDF_STATUS
785  */
786 QDF_STATUS qdf_uint64_parse(const char *int_str, uint64_t *out_int);
787 
788 #define QDF_MAC_ADDR_SIZE 6
789 #define QDF_MAC_ADDR_STR "%02x:%02x:%02x:%02x:%02x:%02x"
790 #define QDF_MAC_ADDR_ARRAY(a) (a)[0], (a)[1], (a)[2], (a)[3], (a)[4], (a)[5]
791 #define QDF_MAC_ADDR_BCAST_INIT { { 0xff, 0xff, 0xff, 0xff, 0xff, 0xff } }
792 #define QDF_MAC_ADDR_ZERO_INIT { { 0, 0, 0, 0, 0, 0 } }
793 
794 /**
795  * struct qdf_mac_addr - A MAC address
796  * @bytes: the raw address bytes array
797  */
798 struct qdf_mac_addr {
799 	uint8_t bytes[QDF_MAC_ADDR_SIZE];
800 };
801 
802 /**
803  * qdf_mac_parse() - parse the given string as a MAC address
804  * @mac_str: the input MAC address string to parse
805  * @out_addr: the output MAC address value, populated on success
806  *
807  * A MAC address is a set of 6, colon-delimited, hexadecimal encoded octets.
808  *
809  * E.g.
810  *	00:00:00:00:00:00 (zero address)
811  *	ff:ff:ff:ff:ff:ff (broadcast address)
812  *	12:34:56:78:90:ab (an arbitrary address)
813  *
814  * This implementation also accepts MAC addresses without colons. Historically,
815  * other delimiters and groupings have been used to represent MAC addresses, but
816  * these are not supported here. Hexadecimal digits may be in either upper or
817  * lower case.
818  *
819  * Return: QDF_STATUS
820  */
821 QDF_STATUS qdf_mac_parse(const char *mac_str, struct qdf_mac_addr *out_addr);
822 
823 #define QDF_IPV4_ADDR_SIZE 4
824 #define QDF_IPV4_ADDR_STR "%d.%d.%d.%d"
825 #define QDF_IPV4_ADDR_ARRAY(a) (a)[0], (a)[1], (a)[2], (a)[3]
826 #define QDF_IPV4_ADDR_ZERO_INIT { { 0, 0, 0, 0 } }
827 
828 /**
829  * struct qdf_ipv4_addr - An IPV4 address
830  * @bytes: the raw address bytes array
831  */
832 struct qdf_ipv4_addr {
833 	uint8_t bytes[QDF_IPV4_ADDR_SIZE];
834 };
835 
836 /**
837  * qdf_ipv4_parse() - parse the given string as an IPV4 address
838  * @ipv4_str: the input IPV4 address string to parse
839  * @out_addr: the output IPV4 address value, populated on success
840  *
841  * An IPV4 address is a set of 4, dot-delimited, decimal encoded octets.
842  *
843  * E.g.
844  *	0.0.0.0 (wildcard address)
845  *	127.0.0.1 (loopback address)
846  *	255.255.255.255 (broadcast address)
847  *	192.168.0.1 (an arbitrary address)
848  *
849  * Historically, non-decimal encodings have also been used to represent IPV4
850  * addresses, but these are not supported here.
851  *
852  * Return: QDF_STATUS
853  */
854 QDF_STATUS qdf_ipv4_parse(const char *ipv4_str, struct qdf_ipv4_addr *out_addr);
855 
856 #define QDF_IPV6_ADDR_SIZE 16
857 #define QDF_IPV6_ADDR_HEXTET_COUNT 8
858 #define QDF_IPV6_ADDR_STR "%x:%x:%x:%x:%x:%x:%x:%x"
859 #define QDF_IPV6_ADDR_ARRAY(a) \
860 	((a)[0] << 8) + (a)[1], ((a)[2] << 8) + (a)[3], \
861 	((a)[4] << 8) + (a)[5], ((a)[6] << 8) + (a)[7], \
862 	((a)[8] << 8) + (a)[9], ((a)[10] << 8) + (a)[11], \
863 	((a)[12] << 8) + (a)[13], ((a)[14] << 8) + (a)[15]
864 #define QDF_IPV6_ADDR_ZERO_INIT \
865 	{ { 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0 } }
866 
867 /**
868  * struct qdf_ipv6_addr - An IPV6 address
869  * @bytes: the raw address bytes array
870  */
871 struct qdf_ipv6_addr {
872 	uint8_t bytes[QDF_IPV6_ADDR_SIZE];
873 };
874 
875 /**
876  * qdf_ipv6_parse() - parse the given string as an IPV6 address
877  * @ipv6_str: the input IPV6 address string to parse
878  * @out_addr: the output IPV6 address value, populated on success
879  *
880  * A hextet is a pair of octets. An IPV6 address is a set of 8, colon-delimited,
881  * hexadecimal encoded hextets. Each hextet may omit leading zeros. One or more
882  * zero-hextets may be "compressed" using a pair of colons ("::"). Up to one
883  * such zero-compression is allowed per address.
884  *
885  * E.g.
886  *	0:0:0:0:0:0:0:0 (unspecified address)
887  *	:: (also the unspecified address)
888  *	0:0:0:0:0:0:0:1 (loopback address)
889  *	::1 (also the loopback address)
890  *	900a:ae7::6 (an arbitrary address)
891  *	900a:ae7:0:0:0:0:0:6 (the same arbitrary address)
892  *
893  * Hexadecimal digits may be in either upper or lower case.
894  *
895  * Return: QDF_STATUS
896  */
897 QDF_STATUS qdf_ipv6_parse(const char *ipv6_str, struct qdf_ipv6_addr *out_addr);
898 
899 /**
900  * qdf_uint8_array_parse() - parse the given string as uint8 array
901  * @in_str: the input string to parse
902  * @out_array: the output uint8 array, populated on success
903  * @array_size: size of the array
904  * @out_size: size of the populated array
905  *
906  * This API is called to convert string (each byte separated by
907  * a comma) into an u8 array
908  *
909  * Return: QDF_STATUS
910  */
911 QDF_STATUS qdf_uint8_array_parse(const char *in_str, uint8_t *out_array,
912 				 qdf_size_t array_size, qdf_size_t *out_size);
913 
914 #define QDF_MAX_NUM_CHAN   (128)
915 
916 #define QDF_BCAST_MAC_ADDR (0xFF)
917 #define QDF_MCAST_IPV4_MAC_ADDR (0x01)
918 #define QDF_MCAST_IPV6_MAC_ADDR (0x33)
919 
920 /**
921  * struct qdf_tso_frag_t - fragments of a single TCP segment
922  * @paddr_low_32: Lower 32 bits of the buffer pointer
923  * @paddr_upper_16: upper 16 bits of the buffer pointer
924  * @length: length of the buffer
925  * @vaddr: virtual address
926  *
927  * This structure holds the fragments of a single TCP segment of a
928  * given jumbo TSO network buffer
929  */
930 struct qdf_tso_frag_t {
931 	uint16_t length;
932 	unsigned char *vaddr;
933 	qdf_dma_addr_t paddr;
934 };
935 
936 #define FRAG_NUM_MAX 6
937 #define TSO_SEG_MAGIC_COOKIE 0x1EED
938 
939 /**
940  * struct qdf_tso_flags_t - TSO specific flags
941  * @tso_enable: Enable transmit segmentation offload
942  * @tcp_flags_mask: Tcp_flag is inserted into the header based
943  * on the mask
944  * @l2_len: L2 length for the msdu
945  * @ip_len: IP length for the msdu
946  * @tcp_seq_num: TCP sequence number
947  * @ip_id: IP identification number
948  *
949  * This structure holds the TSO specific flags extracted from the TSO network
950  * buffer for a given TCP segment
951  */
952 struct qdf_tso_flags_t {
953 	uint32_t tso_enable:1,
954 			reserved_0a:6,
955 			fin:1,
956 			syn:1,
957 			rst:1,
958 			psh:1,
959 			ack:1,
960 			urg:1,
961 			ece:1,
962 			cwr:1,
963 			ns:1,
964 			tcp_flags_mask:9,
965 			reserved_0b:7;
966 
967 	uint32_t l2_len:16,
968 			ip_len:16;
969 
970 	uint32_t tcp_seq_num;
971 
972 	uint32_t ip_id:16,
973 			ipv4_checksum_en:1,
974 			udp_ipv4_checksum_en:1,
975 			udp_ipv6_checksum_en:1,
976 			tcp_ipv4_checksum_en:1,
977 			tcp_ipv6_checksum_en:1,
978 			partial_checksum_en:1,
979 			reserved_3a:10;
980 
981 	uint32_t checksum_offset:14,
982 			reserved_4a:2,
983 			payload_start_offset:14,
984 			reserved_4b:2;
985 
986 	uint32_t payload_end_offset:14,
987 			reserved_5:18;
988 };
989 
990 /**
991  * struct qdf_tso_seg_t - single TSO segment
992  * @tso_flags: TSO flags
993  * @num_frags: number of fragments
994  * @total_len: total length of the packet
995  * @tso_frags: array holding the fragments
996  *
997  * This structure holds the information of a single TSO segment of a jumbo
998  * TSO network buffer
999  */
1000 struct qdf_tso_seg_t {
1001 	struct qdf_tso_flags_t tso_flags;
1002 	uint32_t num_frags;
1003 	uint32_t total_len;
1004 	struct qdf_tso_frag_t tso_frags[FRAG_NUM_MAX];
1005 };
1006 
1007 /**
1008  * TSO seg elem action caller locations: goes into dbg.history below.
1009  * Needed to be defined outside of the feature so that
1010  * callers can be coded without ifdefs (even if they get
1011  * resolved to nothing)
1012  */
1013 enum tsoseg_dbg_caller_e {
1014 	TSOSEG_LOC_UNDEFINED,
1015 	TSOSEG_LOC_INIT1,
1016 	TSOSEG_LOC_INIT2,
1017 	TSOSEG_LOC_FREE,
1018 	TSOSEG_LOC_ALLOC,
1019 	TSOSEG_LOC_DEINIT,
1020 	TSOSEG_LOC_GETINFO,
1021 	TSOSEG_LOC_FILLHTTSEG,
1022 	TSOSEG_LOC_FILLCMNSEG,
1023 	TSOSEG_LOC_PREPARETSO,
1024 	TSOSEG_LOC_TXPREPLLFAST,
1025 	TSOSEG_LOC_UNMAPTSO,
1026 	TSOSEG_LOC_UNMAPLAST,
1027 	TSOSEG_LOC_FORCE_FREE,
1028 };
1029 #ifdef TSOSEG_DEBUG
1030 
1031 /**
1032  * WARNING: Don't change the history size without changing the wrap
1033  *  code in qdf_tso_seg_dbg_record function
1034  */
1035 #define MAX_TSO_SEG_ACT_HISTORY 16
1036 struct qdf_tso_seg_dbg_history_t {
1037 	uint64_t ts;
1038 	short    id;
1039 };
1040 struct qdf_tso_seg_dbg_t {
1041 	void    *txdesc;  /* owner - (ol_txrx_tx_desc_t *) */
1042 	qdf_atomic_t cur; /* index of last valid entry */
1043 	struct qdf_tso_seg_dbg_history_t h[MAX_TSO_SEG_ACT_HISTORY];
1044 };
1045 #endif /* TSOSEG_DEBUG */
1046 
1047 /**
1048  * qdf_tso_seg_elem_t - tso segment element
1049  * @next: pointer to the next segment
1050  * @seg: instance of segment
1051  */
1052 struct qdf_tso_seg_elem_t {
1053 	struct qdf_tso_seg_elem_t *next;
1054 	struct qdf_tso_seg_t seg;
1055 	uint32_t cookie:13,
1056 		on_freelist:1,
1057 		sent_to_target:1,
1058 		force_free:1;
1059 #ifdef TSOSEG_DEBUG
1060 	struct qdf_tso_seg_dbg_t dbg;
1061 #endif /* TSOSEG_DEBUG */
1062 };
1063 
1064 /**
1065  * struct qdf_tso_num_seg_t - single element to count for num of seg
1066  * @tso_cmn_num_seg: num of seg in a jumbo skb
1067  *
1068  * This structure holds the information of num of segments of a jumbo
1069  * TSO network buffer.
1070  */
1071 struct qdf_tso_num_seg_t {
1072 	uint32_t tso_cmn_num_seg;
1073 };
1074 
1075 /**
1076  * qdf_tso_num_seg_elem_t - num of tso segment element for jumbo skb
1077  * @next: pointer to the next segment
1078  * @num_seg: instance of num of seg
1079  */
1080 struct qdf_tso_num_seg_elem_t {
1081 	struct qdf_tso_num_seg_elem_t *next;
1082 	struct qdf_tso_num_seg_t num_seg;
1083 };
1084 
1085 /**
1086  * struct qdf_tso_info_t - TSO information extracted
1087  * @is_tso: is this is a TSO frame
1088  * @num_segs: number of segments
1089  * @tso_seg_list: list of TSO segments for this jumbo packet
1090  * @curr_seg: segment that is currently being processed
1091  * @tso_num_seg_list: num of tso seg for this jumbo packet
1092  * @msdu_stats_idx: msdu index for tso stats
1093  *
1094  * This structure holds the TSO information extracted after parsing the TSO
1095  * jumbo network buffer. It contains a chain of the TSO segments belonging to
1096  * the jumbo packet
1097  */
1098 struct qdf_tso_info_t {
1099 	uint8_t is_tso;
1100 	uint32_t num_segs;
1101 	struct qdf_tso_seg_elem_t *tso_seg_list;
1102 	struct qdf_tso_seg_elem_t *curr_seg;
1103 	struct qdf_tso_num_seg_elem_t *tso_num_seg_list;
1104 	uint32_t msdu_stats_idx;
1105 };
1106 
1107 /**
1108  * Used to set classify bit in CE desc.
1109  */
1110 #define QDF_CE_TX_CLASSIFY_BIT_S   5
1111 
1112 /**
1113  * QDF_CE_TX_PKT_TYPE_BIT_S - 2 bits starting at bit 6 in CE desc.
1114  */
1115 #define QDF_CE_TX_PKT_TYPE_BIT_S   6
1116 
1117 /**
1118  * QDF_CE_TX_PKT_OFFSET_BIT_S - 12 bits --> 16-27, in the CE desciptor
1119  *  the length of HTT/HTC descriptor
1120  */
1121 #define QDF_CE_TX_PKT_OFFSET_BIT_S  16
1122 
1123 /**
1124  * QDF_CE_TX_PKT_OFFSET_BIT_M - Mask for packet offset in the CE descriptor.
1125  */
1126 #define QDF_CE_TX_PKT_OFFSET_BIT_M   0x0fff0000
1127 
1128 /**
1129  * enum qdf_suspend_type - type of suspend
1130  * @QDF_SYSTEM_SUSPEND: System suspend triggered wlan suspend
1131  * @QDF_RUNTIME_SUSPEND: Runtime pm inactivity timer triggered wlan suspend
1132  */
1133 enum qdf_suspend_type {
1134 	QDF_SYSTEM_SUSPEND,
1135 	QDF_RUNTIME_SUSPEND
1136 };
1137 
1138 /**
1139  * enum qdf_hang_reason - host hang/ssr reason
1140  * @CDS_REASON_UNSPECIFIED: Unspecified reason
1141  * @CDS_RX_HASH_NO_ENTRY_FOUND: No Map for the MAC entry for the received frame
1142  * @CDS_PEER_DELETION_TIMEDOUT: peer deletion timeout happened
1143  * @CDS_PEER_UNMAP_TIMEDOUT: peer unmap timeout
1144  * @CDS_SCAN_REQ_EXPIRED: Scan request timed out
1145  * @CDS_SCAN_ATTEMPT_FAILURES: Consecutive Scan attempt failures
1146  * @CDS_GET_MSG_BUFF_FAILURE: Unable to get the message buffer
1147  * @CDS_ACTIVE_LIST_TIMEOUT: Current command processing is timedout
1148  * @CDS_SUSPEND_TIMEOUT: Timeout for an ACK from FW for suspend request
1149  * @CDS_RESUME_TIMEOUT: Timeout for an ACK from FW for resume request
1150  */
1151 enum qdf_hang_reason {
1152 	QDF_REASON_UNSPECIFIED = 0,
1153 	QDF_RX_HASH_NO_ENTRY_FOUND = 1,
1154 	QDF_PEER_DELETION_TIMEDOUT = 2,
1155 	QDF_PEER_UNMAP_TIMEDOUT = 3,
1156 	QDF_SCAN_REQ_EXPIRED = 4,
1157 	QDF_SCAN_ATTEMPT_FAILURES = 5,
1158 	QDF_GET_MSG_BUFF_FAILURE = 6,
1159 	QDF_ACTIVE_LIST_TIMEOUT = 7,
1160 	QDF_SUSPEND_TIMEOUT = 8,
1161 	QDF_RESUME_TIMEOUT = 9,
1162 };
1163 
1164 /**
1165  * enum qdf_stats_verbosity_level - Verbosity levels for stats
1166  * for which want to have different levels
1167  * @QDF_STATS_VERBOSITY_LEVEL_LOW: Stats verbosity level low
1168  * @QDF_STATS_VERBOSITY_LEVEL_HIGH: Stats verbosity level high
1169  */
1170 enum qdf_stats_verbosity_level {
1171 	QDF_STATS_VERBOSITY_LEVEL_LOW,
1172 	QDF_STATS_VERBOSITY_LEVEL_HIGH
1173 };
1174 
1175 /**
1176  * enum qdf_clock_id - The clock IDs of the various system clocks
1177  * @QDF_CLOCK_REALTIME: Clock is close to current time of day
1178  * @QDF_CLOCK_MONOTONIC: Clock is absolute elapsed time
1179  */
1180 enum qdf_clock_id {
1181 	QDF_CLOCK_REALTIME = __QDF_CLOCK_REALTIME,
1182 	QDF_CLOCK_MONOTONIC = __QDF_CLOCK_MONOTONIC
1183 };
1184 
1185 /**
1186  * enum qdf_hrtimer_mode - Mode arguments of qdf_hrtimer_data_t
1187  * related functions
1188  * @QDF_HRTIMER_MODE_ABS: Time value is absolute
1189  * @QDF_HRTIMER_MODE_REL: Time value is relative to now
1190  * @QDF_HRTIMER_MODE_PINNED: Timer is bound to CPU
1191  */
1192 enum qdf_hrtimer_mode {
1193 	QDF_HRTIMER_MODE_ABS = __QDF_HRTIMER_MODE_ABS,
1194 	QDF_HRTIMER_MODE_REL = __QDF_HRTIMER_MODE_REL,
1195 	QDF_HRTIMER_MODE_PINNED =  __QDF_HRTIMER_MODE_PINNED,
1196 };
1197 
1198 /**
1199  * enum qdf_hrtimer_restart_status - Return values for the
1200  * qdf_hrtimer_data_t callback function
1201  * @QDF_HRTIMER_NORESTART: Timer is not restarted
1202  * @QDF_HRTIMER_RESTART: Timer must be restarted
1203  */
1204 enum qdf_hrtimer_restart_status {
1205 	QDF_HRTIMER_NORESTART = __QDF_HRTIMER_NORESTART,
1206 	QDF_HRTIMER_RESTART = __QDF_HRTIMER_RESTART,
1207 };
1208 
1209 /**
1210  * enum qdf_context_mode - Values for the
1211  * hrtimer context
1212  * @QDF_CONTEXT_HARDWARE: Runs in hw interrupt context
1213  * @QDF_CONTEXT_TASKLET: Runs in tasklet context
1214  */
1215 enum qdf_context_mode {
1216 	QDF_CONTEXT_HARDWARE = 0,
1217 	QDF_CONTEXT_TASKLET = 1,
1218 };
1219 
1220 #endif /* __QDF_TYPES_H */
1221