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