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