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