dhd.h - kernel/google-modules/wlan/bcmdhd/bcm4390 - Git at Google

 /*
  * Header file describing the internal (inter-module) DHD interfaces.
  *
  * Provides type definitions and function prototypes used to link the
  * DHD OS, bus, and protocol modules.
  *
  * Copyright (C) 2024, Broadcom.
  *
  *      Unless you and Broadcom execute a separate written software license
  * agreement governing use of this software, this software is licensed to you
  * under the terms of the GNU General Public License version 2 (the "GPL"),
  * available at http://www.broadcom.com/licenses/GPLv2.php, with the
  * following added to such license:
  *
  *      As a special exception, the copyright holders of this software give you
  * permission to link this software with independent modules, and to copy and
  * distribute the resulting executable under terms of your choice, provided that
  * you also meet, for each linked independent module, the terms and conditions of
  * the license of that module.  An independent module is a module which is not
  * derived from this software.  The special exception does not apply to any
  * modifications of the software.
  *
  *
  * <<Broadcom-WL-IPTag/Dual:>>
  */


 /****************
  * Common types *
  */

 #ifndef _dhd_h_
 #define _dhd_h_

 #if defined(__linux__)
 #include <linux/init.h>
 #include <linux/firmware.h>
 #include <linux/kernel.h>
 #include <linux/slab.h>
 #include <linux/skbuff.h>
 #include <linux/netdevice.h>
 #include <linux/etherdevice.h>
 #include <linux/random.h>
 #include <linux/spinlock.h>
 #include <linux/ethtool.h>
 #include <linux/proc_fs.h>
 #include <asm/uaccess.h>
 #include <asm/unaligned.h>
 #include <linux/fs.h>
 #include <linux/namei.h>
 #if LINUX_VERSION_CODE >= KERNEL_VERSION(4, 11, 0)
 #include <linux/sched/types.h>
 #endif /* LINUX_VERSION_CODE >= KERNEL_VERSION(4, 11, 0) */
 #ifdef DHD_BUZZZ_LOG_ENABLED
 #include <dhd_buzzz.h>
 #endif /* DHD_BUZZZ_LOG_ENABLED */
 /* The kernel threading is sdio-specific */
 struct task_struct;
 struct sched_param;
 #if defined(BT_OVER_SDIO)
 #include <dhd_bt_interface.h>
 #endif /* defined (BT_OVER_SDIO) */
 int setScheduler(struct task_struct *p, int policy, struct sched_param *param);
 int get_scheduler_policy(struct task_struct *p);
 #else /* __linux__ */
 #define ENOMEM		1
 #define EFAULT      2
 #define EINVAL		3
 #define EIO			4
 #define ETIMEDOUT	5
 #define ENODATA 6
 #define EREMOTEIO   7
 #define ENODEV      8
 #define ERESTARTSYS 512
 #endif /* __linux__ */
 #define MAX_EVENT	16

 #define ALL_INTERFACES	0xff

 /* H2D and D2H ring dump is enabled by default */
 #ifdef PCIE_FULL_DONGLE
 #define DHD_DUMP_PCIE_RINGS
 #endif /* PCIE_FULL_DONGLE */

 #include <osl.h>

 #include <wlioctl.h>
 #include <dhdioctl.h>
 #include <wlfc_proto.h>
 #include <hnd_armtrap.h>
 #if defined(DUMP_IOCTL_IOV_LIST) || defined(DHD_DEBUG)
 #include <bcmutils.h>
 #endif /* DUMP_IOCTL_IOV_LIST || DHD_DEBUG */
 #if defined(BCMWDF)
 #include <wdf.h>
 #include <WdfMiniport.h>
 #endif /* (BCMWDF)  */

 #ifdef WL_CFGVENDOR_SEND_HANG_EVENT
 #include <dnglioctl.h>
 #endif /* WL_CFGVENDOR_SEND_HANG_EVENT */
 #ifdef DHD_ERPOM
 #include <pom.h>
 #ifdef PCIE_OOB
 /*
  * Both ERPOM and PCIE_OOB depend on ftdi to programme GPIOs.
  * Both features operating parallelly make the GPIOs go outof sync.
  * So only one feature is expected to be present at a time.
  */
 #error "PCIE_OOB enabled"
 #endif /* PCIE_OOB */
 #endif /* DHD_ERPOM */

 #include <dngl_stats.h>
 #include <hnd_pktq.h>

 #include <dhd_logger.h>
 #ifdef DEBUG_DPC_THREAD_WATCHDOG
 #define MAX_RESCHED_CNT 600
 #endif /* DEBUG_DPC_THREAD_WATCHDOG */

 #if defined(__linux__)
 #if (LINUX_VERSION_CODE >= KERNEL_VERSION(3, 14, 0) && LINUX_VERSION_CODE < \
 	KERNEL_VERSION(3, 18, 0) || defined(CONFIG_BCMDHD_VENDOR_EXT))
 #define WL_VENDOR_EXT_SUPPORT
 #endif /* 3.18 > KERNEL_VER >= 3.14 || defined(CONFIG_BCMDHD_VENDOR_EXT) */
 #endif /* defined(__linux__) */

 #if defined(KEEP_ALIVE)
 /* Default KEEP_ALIVE Period is 55 sec to prevent AP from sending Keep Alive probe frame */
 #define KEEP_ALIVE_PERIOD 55000
 #define NULL_PKT_STR	"null_pkt"
 #endif /* KEEP_ALIVE */

 /* By default enabled from here, later the WQ code will be removed */
 #define DHD_USE_KTHREAD_FOR_LOGTRACE

 /* Forward decls */
 struct dhd_bus;
 struct dhd_prot;
 struct dhd_info;
 struct dhd_ioctl;
 struct dhd_dbg;
 struct dhd_ts;
 #ifdef DNGL_AXI_ERROR_LOGGING
 struct dhd_axi_error_dump;
 #endif /* DNGL_AXI_ERROR_LOGGING */

 /* module param */
 extern int dhd_logger;

 /* The level of bus communication with the dongle */
 enum dhd_bus_state {
 	DHD_BUS_DOWN,		/* Not ready for frame transfers */
 	DHD_BUS_LOAD,		/* Download access only (CPU reset) */
 	DHD_BUS_DATA,		/* Ready for frame transfers */
 	DHD_BUS_SUSPEND,	/* Bus has been suspended */
 	DHD_BUS_DOWN_IN_PROGRESS,	/* Bus going Down */
 };

 /* The level of bus communication with the dongle */
 enum dhd_bus_devreset_type {
 	DHD_BUS_DEVRESET_ON = 0,	/* ON */
 	DHD_BUS_DEVRESET_OFF = 1,		/* OFF */
 	DHD_BUS_DEVRESET_FLR = 2,		/* FLR */
 	DHD_BUS_DEVRESET_FLR_FORCE_FAIL = 3,	/* FLR FORCE FAIL */
 	DHD_BUS_DEVRESET_QUIESCE = 4,		/* FLR */
 };

 /*
  * Bit fields to Indicate clean up process that wait till they are finished.
  * Future synchronizable processes can add their bit filed below and update
  * their functionalities accordingly
  */
 #define DHD_BUS_BUSY_IN_TX                   0x01
 #define DHD_BUS_BUSY_IN_SEND_PKT             0x02
 #define DHD_BUS_BUSY_IN_DPC                  0x04
 #define DHD_BUS_BUSY_IN_WD                   0x08
 #define DHD_BUS_BUSY_IN_IOVAR                0x10
 #define DHD_BUS_BUSY_IN_DHD_IOVAR            0x20
 #define DHD_BUS_BUSY_SUSPEND_IN_PROGRESS     0x40
 #define DHD_BUS_BUSY_RESUME_IN_PROGRESS      0x80
 #define DHD_BUS_BUSY_RPM_SUSPEND_IN_PROGRESS 0x100
 #define DHD_BUS_BUSY_RPM_SUSPEND_DONE        0x200
 #define DHD_BUS_BUSY_RPM_RESUME_IN_PROGRESS  0x400
 #define DHD_BUS_BUSY_RPM_ALL                 (DHD_BUS_BUSY_RPM_SUSPEND_DONE | \
 		DHD_BUS_BUSY_RPM_SUSPEND_IN_PROGRESS | \
 		DHD_BUS_BUSY_RPM_RESUME_IN_PROGRESS)
 #define DHD_BUS_BUSY_IN_CHECKDIED		0x800
 #define DHD_BUS_BUSY_IN_MEMDUMP			0x1000
 #define DHD_BUS_BUSY_IN_SSSRDUMP		0x2000
 #define DHD_BUS_BUSY_IN_LOGDUMP			0x4000
 #define DHD_BUS_BUSY_IN_HALDUMP			0x8000
 #define DHD_BUS_BUSY_IN_NAPI			0x10000
 #define DHD_BUS_BUSY_IN_DS_DEASSERT		0x20000
 #define DHD_BUS_BUSY_IN_DUMP_DONGLE_MEM		0x40000
 #define DHD_BUS_BUSY_IN_SYSFS_DUMP		0x80000
 #define DHD_BUS_BUSY_IN_PM_CALLBACK		0x100000
 #define DHD_BUS_BUSY_IN_BT_FW_DWNLD		0x200000
 #define DHD_BUS_BUSY_IN_SSSR			0x400000

 #define DHD_BUS_BUSY_SET_IN_TX(dhdp) \
 	(dhdp)->dhd_bus_busy_state |= DHD_BUS_BUSY_IN_TX
 #define DHD_BUS_BUSY_SET_IN_SEND_PKT(dhdp) \
 	(dhdp)->dhd_bus_busy_state |= DHD_BUS_BUSY_IN_SEND_PKT
 #define DHD_BUS_BUSY_SET_IN_DPC(dhdp) \
 	(dhdp)->dhd_bus_busy_state |= DHD_BUS_BUSY_IN_DPC
 #define DHD_BUS_BUSY_SET_IN_WD(dhdp) \
 	(dhdp)->dhd_bus_busy_state |= DHD_BUS_BUSY_IN_WD
 #define DHD_BUS_BUSY_SET_IN_IOVAR(dhdp) \
 	(dhdp)->dhd_bus_busy_state |= DHD_BUS_BUSY_IN_IOVAR
 #define DHD_BUS_BUSY_SET_IN_DHD_IOVAR(dhdp) \
 	(dhdp)->dhd_bus_busy_state |= DHD_BUS_BUSY_IN_DHD_IOVAR
 #define DHD_BUS_BUSY_SET_SUSPEND_IN_PROGRESS(dhdp) \
 	(dhdp)->dhd_bus_busy_state |= DHD_BUS_BUSY_SUSPEND_IN_PROGRESS
 #define DHD_BUS_BUSY_SET_RESUME_IN_PROGRESS(dhdp) \
 	(dhdp)->dhd_bus_busy_state |= DHD_BUS_BUSY_RESUME_IN_PROGRESS
 #define DHD_BUS_BUSY_SET_RPM_SUSPEND_IN_PROGRESS(dhdp) \
 	(dhdp)->dhd_bus_busy_state |= DHD_BUS_BUSY_RPM_SUSPEND_IN_PROGRESS
 #define DHD_BUS_BUSY_SET_RPM_SUSPEND_DONE(dhdp) \
 	(dhdp)->dhd_bus_busy_state |= DHD_BUS_BUSY_RPM_SUSPEND_DONE
 #define DHD_BUS_BUSY_SET_RPM_RESUME_IN_PROGRESS(dhdp) \
 	(dhdp)->dhd_bus_busy_state |= DHD_BUS_BUSY_RPM_RESUME_IN_PROGRESS
 #define DHD_BUS_BUSY_SET_IN_CHECKDIED(dhdp) \
 	(dhdp)->dhd_bus_busy_state |= DHD_BUS_BUSY_IN_CHECKDIED
 #define DHD_BUS_BUSY_SET_IN_MEMDUMP(dhdp) \
 	(dhdp)->dhd_bus_busy_state |= DHD_BUS_BUSY_IN_MEMDUMP
 #define DHD_BUS_BUSY_SET_IN_SSSRDUMP(dhdp) \
 	(dhdp)->dhd_bus_busy_state |= DHD_BUS_BUSY_IN_SSSRDUMP
 #define DHD_BUS_BUSY_SET_IN_LOGDUMP(dhdp) \
 	(dhdp)->dhd_bus_busy_state |= DHD_BUS_BUSY_IN_LOGDUMP
 #define DHD_BUS_BUSY_SET_IN_HALDUMP(dhdp) \
 	(dhdp)->dhd_bus_busy_state |= DHD_BUS_BUSY_IN_HALDUMP
 #define DHD_BUS_BUSY_SET_IN_NAPI(dhdp) \
 	(dhdp)->dhd_bus_busy_state |= DHD_BUS_BUSY_IN_NAPI
 #define DHD_BUS_BUSY_SET_IN_DS_DEASSERT(dhdp) \
 	(dhdp)->dhd_bus_busy_state |= DHD_BUS_BUSY_IN_DS_DEASSERT
 #define DHD_BUS_BUSY_SET_IN_DUMP_DONGLE_MEM(dhdp) \
 	(dhdp)->dhd_bus_busy_state |= DHD_BUS_BUSY_IN_DUMP_DONGLE_MEM
 #define DHD_BUS_BUSY_SET_IN_SYSFS_DUMP(dhdp) \
 	(dhdp)->dhd_bus_busy_state |= DHD_BUS_BUSY_IN_SYSFS_DUMP
 #define DHD_BUS_BUSY_SET_IN_PM_CALLBACK(dhdp) \
 	(dhdp)->dhd_bus_busy_state |= DHD_BUS_BUSY_IN_PM_CALLBACK
 #define DHD_BUS_BUSY_SET_IN_BT_FW_DWNLD(dhdp) \
 	(dhdp)->dhd_bus_busy_state |= DHD_BUS_BUSY_IN_BT_FW_DWNLD
 #define DHD_BUS_BUSY_SET_IN_SSSR(dhdp) \
 	(dhdp)->dhd_bus_busy_state |= DHD_BUS_BUSY_IN_SSSR

 #define DHD_BUS_BUSY_CLEAR_IN_TX(dhdp) \
 	(dhdp)->dhd_bus_busy_state &= ~DHD_BUS_BUSY_IN_TX
 #define DHD_BUS_BUSY_CLEAR_IN_SEND_PKT(dhdp) \
 	(dhdp)->dhd_bus_busy_state &= ~DHD_BUS_BUSY_IN_SEND_PKT
 #define DHD_BUS_BUSY_CLEAR_IN_DPC(dhdp) \
 	(dhdp)->dhd_bus_busy_state &= ~DHD_BUS_BUSY_IN_DPC
 #define DHD_BUS_BUSY_CLEAR_IN_WD(dhdp) \
 	(dhdp)->dhd_bus_busy_state &= ~DHD_BUS_BUSY_IN_WD
 #define DHD_BUS_BUSY_CLEAR_IN_IOVAR(dhdp) \
 	(dhdp)->dhd_bus_busy_state &= ~DHD_BUS_BUSY_IN_IOVAR
 #define DHD_BUS_BUSY_CLEAR_IN_DHD_IOVAR(dhdp) \
 	(dhdp)->dhd_bus_busy_state &= ~DHD_BUS_BUSY_IN_DHD_IOVAR
 #define DHD_BUS_BUSY_CLEAR_SUSPEND_IN_PROGRESS(dhdp) \
 	(dhdp)->dhd_bus_busy_state &= ~DHD_BUS_BUSY_SUSPEND_IN_PROGRESS
 #define DHD_BUS_BUSY_CLEAR_RESUME_IN_PROGRESS(dhdp) \
 	(dhdp)->dhd_bus_busy_state &= ~DHD_BUS_BUSY_RESUME_IN_PROGRESS
 #define DHD_BUS_BUSY_CLEAR_RPM_SUSPEND_IN_PROGRESS(dhdp) \
 	(dhdp)->dhd_bus_busy_state &= ~DHD_BUS_BUSY_RPM_SUSPEND_IN_PROGRESS
 #define DHD_BUS_BUSY_CLEAR_RPM_SUSPEND_DONE(dhdp) \
 	(dhdp)->dhd_bus_busy_state &= ~DHD_BUS_BUSY_RPM_SUSPEND_DONE
 #define DHD_BUS_BUSY_CLEAR_RPM_RESUME_IN_PROGRESS(dhdp) \
 	(dhdp)->dhd_bus_busy_state &= ~DHD_BUS_BUSY_RPM_RESUME_IN_PROGRESS
 #define DHD_BUS_BUSY_CLEAR_IN_CHECKDIED(dhdp) \
 	(dhdp)->dhd_bus_busy_state &= ~DHD_BUS_BUSY_IN_CHECKDIED
 #define DHD_BUS_BUSY_CLEAR_IN_MEMDUMP(dhdp) \
 	(dhdp)->dhd_bus_busy_state &= ~DHD_BUS_BUSY_IN_MEMDUMP
 #define DHD_BUS_BUSY_CLEAR_IN_SSSRDUMP(dhdp) \
 	(dhdp)->dhd_bus_busy_state &= ~DHD_BUS_BUSY_IN_SSSRDUMP
 #define DHD_BUS_BUSY_CLEAR_IN_LOGDUMP(dhdp) \
 	(dhdp)->dhd_bus_busy_state &= ~DHD_BUS_BUSY_IN_LOGDUMP
 #define DHD_BUS_BUSY_CLEAR_IN_HALDUMP(dhdp) \
 	(dhdp)->dhd_bus_busy_state &= ~DHD_BUS_BUSY_IN_HALDUMP
 #define DHD_BUS_BUSY_CLEAR_IN_NAPI(dhdp) \
 	(dhdp)->dhd_bus_busy_state &= ~DHD_BUS_BUSY_IN_NAPI
 #define DHD_BUS_BUSY_CLEAR_IN_DS_DEASSERT(dhdp) \
 	(dhdp)->dhd_bus_busy_state &= ~DHD_BUS_BUSY_IN_DS_DEASSERT
 #define DHD_BUS_BUSY_CLEAR_IN_DUMP_DONGLE_MEM(dhdp) \
 	(dhdp)->dhd_bus_busy_state &= ~DHD_BUS_BUSY_IN_DUMP_DONGLE_MEM
 #define DHD_BUS_BUSY_CLEAR_IN_SYSFS_DUMP(dhdp) \
 	(dhdp)->dhd_bus_busy_state &= ~DHD_BUS_BUSY_IN_SYSFS_DUMP
 #define DHD_BUS_BUSY_CLEAR_IN_PM_CALLBACK(dhdp) \
 	(dhdp)->dhd_bus_busy_state &= ~DHD_BUS_BUSY_IN_PM_CALLBACK
 #define DHD_BUS_BUSY_CLEAR_IN_BT_FW_DWNLD(dhdp) \
 	(dhdp)->dhd_bus_busy_state &= ~DHD_BUS_BUSY_IN_BT_FW_DWNLD
 #define DHD_BUS_BUSY_CLEAR_IN_SSSR(dhdp) \
 	(dhdp)->dhd_bus_busy_state &= ~DHD_BUS_BUSY_IN_SSSR

 #define DHD_BUS_BUSY_CHECK_IN_TX(dhdp) \
 	((dhdp)->dhd_bus_busy_state & DHD_BUS_BUSY_IN_TX)
 #define DHD_BUS_BUSY_CHECK_IN_SEND_PKT(dhdp) \
 	((dhdp)->dhd_bus_busy_state & DHD_BUS_BUSY_IN_SEND_PKT)
 #define DHD_BUS_BUSY_CHECK_IN_DPC(dhdp) \
 	((dhdp)->dhd_bus_busy_state & DHD_BUS_BUSY_IN_DPC)
 #define DHD_BUS_BUSY_CHECK_IN_WD(dhdp) \
 	((dhdp)->dhd_bus_busy_state & DHD_BUS_BUSY_IN_WD)
 #define DHD_BUS_BUSY_CHECK_IN_IOVAR(dhdp) \
 	((dhdp)->dhd_bus_busy_state & DHD_BUS_BUSY_IN_IOVAR)
 #define DHD_BUS_BUSY_CHECK_IN_DHD_IOVAR(dhdp) \
 	((dhdp)->dhd_bus_busy_state & DHD_BUS_BUSY_IN_DHD_IOVAR)
 #define DHD_BUS_BUSY_CHECK_SUSPEND_IN_PROGRESS(dhdp) \
 	((dhdp)->dhd_bus_busy_state & DHD_BUS_BUSY_SUSPEND_IN_PROGRESS)
 #define DHD_BUS_BUSY_CHECK_RESUME_IN_PROGRESS(dhdp) \
 	((dhdp)->dhd_bus_busy_state & DHD_BUS_BUSY_RESUME_IN_PROGRESS)
 #define DHD_BUS_BUSY_CHECK_RPM_SUSPEND_IN_PROGRESS(dhdp) \
 	((dhdp)->dhd_bus_busy_state & DHD_BUS_BUSY_RPM_SUSPEND_IN_PROGRESS)
 #define DHD_BUS_BUSY_CHECK_RPM_SUSPEND_DONE(dhdp) \
 	((dhdp)->dhd_bus_busy_state & DHD_BUS_BUSY_RPM_SUSPEND_DONE)
 #define DHD_BUS_BUSY_CHECK_RPM_RESUME_IN_PROGRESS(dhdp) \
 	((dhdp)->dhd_bus_busy_state & DHD_BUS_BUSY_RPM_RESUME_IN_PROGRESS)
 #define DHD_BUS_BUSY_CHECK_RPM_ALL(dhdp) \
 	((dhdp)->dhd_bus_busy_state & DHD_BUS_BUSY_RPM_ALL)
 #define DHD_BUS_BUSY_CHECK_IN_CHECKDIED(dhdp) \
 	((dhdp)->dhd_bus_busy_state & DHD_BUS_BUSY_IN_CHECKDIED)
 #define DHD_BUS_BUSY_CHECK_IN_MEMDUMP(dhdp) \
 	((dhdp)->dhd_bus_busy_state & DHD_BUS_BUSY_IN_MEMDUMP)
 #define DHD_BUS_BUSY_CHECK_IN_SSSRDUMP(dhdp) \
 	((dhdp)->dhd_bus_busy_state & DHD_BUS_BUSY_IN_SSSRDUMP)
 #define DHD_BUS_BUSY_CHECK_IN_LOGDUMP(dhdp) \
 	((dhdp)->dhd_bus_busy_state & DHD_BUS_BUSY_IN_LOGDUMP)
 #define DHD_BUS_BUSY_CHECK_IN_HALDUMP(dhdp) \
 	((dhdp)->dhd_bus_busy_state & DHD_BUS_BUSY_IN_HALDUMP)
 #define DHD_BUS_BUSY_CHECK_IN_DS_DEASSERT(dhdp) \
 	((dhdp)->dhd_bus_busy_state & DHD_BUS_BUSY_IN_DS_DEASSERT)
 #define DHD_BUS_BUSY_CHECK_IN_DUMP_DONGLE_MEM(dhdp) \
 	((dhdp)->dhd_bus_busy_state & DHD_BUS_BUSY_IN_DUMP_DONGLE_MEM)
 #define DHD_BUS_BUSY_CHECK_IN_SYSFS_DUMP(dhdp) \
 	((dhdp)->dhd_bus_busy_state & DHD_BUS_BUSY_IN_SYSFS_DUMP)
 #define DHD_BUS_BUSY_CHECK_IN_SSSR(dhdp) \
 	((dhdp)->dhd_bus_busy_state & DHD_BUS_BUSY_IN_SSSR)

 #define DHD_BUS_BUSY_CHECK_IDLE(dhdp) \
 	((dhdp)->dhd_bus_busy_state == 0)

 #define DHD_BUS_CHECK_SUSPEND_OR_SUSPEND_IN_PROGRESS(dhdp) \
 	((dhdp)->busstate == DHD_BUS_SUSPEND || DHD_BUS_BUSY_CHECK_SUSPEND_IN_PROGRESS(dhdp))

 #define DHD_BUS_CHECK_ANY_SUSPEND_IN_PROGRESS(dhdp) \
 		(DHD_BUS_BUSY_CHECK_SUSPEND_IN_PROGRESS(dhdp) || \
 		 DHD_BUS_BUSY_CHECK_RPM_SUSPEND_IN_PROGRESS(dhdp))

 #define DHD_BUS_CHECK_SUSPEND_OR_ANY_SUSPEND_IN_PROGRESS(dhdp) \
 	((dhdp)->busstate == DHD_BUS_SUSPEND || DHD_BUS_CHECK_ANY_SUSPEND_IN_PROGRESS(dhdp))

 #define DHD_BUS_CHECK_DOWN_OR_DOWN_IN_PROGRESS(dhdp) \
 		((dhdp)->busstate == DHD_BUS_DOWN || (dhdp)->busstate == DHD_BUS_DOWN_IN_PROGRESS)

 /* IOVar flags for common error checks */
 #define DHD_IOVF_PWRREQ_BYPASS	(1<<0) /* flags to prevent bp access during host sleep state */

 #define MAX_MTU_SZ (1600u)

 #ifdef PCIE_INB_DW
 #define DHD_CHECK_CFG_IN_PROGRESS(dhdp) \
 	((INBAND_DW_ENAB((dhdp)->bus)) ? dhd_check_cfg_in_progress(dhdp) : FALSE)
 #else
 #define DHD_CHECK_CFG_IN_PROGRESS(dhdp) FALSE
 #endif /* PCIE_INB_DW */

 #ifndef USEC_PER_SEC
 #define USEC_PER_SEC (1000 * 1000)
 #endif
 #ifndef MSEC_PER_SEC
 #define MSEC_PER_SEC 1000u
 #endif
 #if defined(__linux__)
 /* (u64)result = (u64)dividend / (u64)divisor */
 #define DIV_U64_BY_U64(dividend, divisor)	div64_u64(dividend, divisor)

 /* (u64)result = (u64)dividend / (u32)divisor */
 #define DIV_U64_BY_U32(dividend, divisor)	div_u64(dividend, divisor)

 /* Be careful while using this, as it divides dividend also
  * (u32)remainder = (u64)dividend % (u32)divisor
  * (u64)dividend = (u64)dividend / (u32)divisor
  */
 #define DIV_AND_MOD_U64_BY_U32(dividend, divisor)	do_div(dividend, divisor)

 /* (u32)remainder = (u64)dividend % (u32)divisor */
 #define MOD_U64_BY_U32(dividend, divisor) ({				\
 	uint64 temp_dividend = (dividend);				\
 	uint32 rem = DIV_AND_MOD_U64_BY_U32(temp_dividend, (divisor));	\
 	rem;								\
 })

 #define SEC_USEC_FMT \
 	"%5llu.%06u"
 #else
 /* (u64)result = (u64)dividend / (u64)divisor */
 #define DIV_U64_BY_U64(dividend, divisor)	(uint64)(dividend) / (uint64)(divisor)

 /* (u64)result = (u64)dividend / (u32)divisor */
 #define DIV_U64_BY_U32(dividend, divisor)	(uint64)(dividend) / (uint32)(divisor)

 /* Be careful while using this, as it divides dividend also
  * (u32)remainder = (u64)dividend % (u32)divisor
  * (u64)dividend = (u64)dividend / (u32)divisor
  */
 #define DIV_AND_MOD_U64_BY_U32(dividend, divisor) ({		\
 	uint32 rem = (uint64)(dividend) % (uint32)(divisor);	\
 	(dividend) = (uint64)(dividend) / (uint32)(divisor);	\
 	rem;							\
 })

 /* (u32)remainder = (u64)dividend % (u32)divisor */
 #define MOD_U64_BY_U32(dividend, divisor)	(uint32)((uint64)(dividend) % (uint32)(divisor))

 #define SEC_USEC_FMT \
 	"%015llu.%06u"
 #endif /* __linux__ */

 /* t: time in nano second */
 #define GET_SEC_USEC(t) \
 	DIV_U64_BY_U32(t, NSEC_PER_SEC), \
 	((uint32)(MOD_U64_BY_U32(t, NSEC_PER_SEC) / (uint32)NSEC_PER_USEC))

 /* Download Types */
 typedef enum download_type {
 	FW,
 	NVRAM,
 	CLM_BLOB,
 	TXCAP_BLOB
 } download_type_t;

 #if defined(NDIS)
 /* Firmware requested operation mode */
 #define STA_MASK			0x0001
 #define HOSTAPD_MASK		0x0002
 #define WFD_MASK			0x0004
 #define SOFTAP_FW_MASK	0x0008
 #define P2P_GO_ENABLED		0x0010
 #define P2P_GC_ENABLED		0x0020
 #define CONCURENT_MASK		0x00F0
 #endif /* #if defined(NDIS) */

 /* For supporting multiple interfaces */
 #define DHD_MAX_IFS			16
 #define DHD_MAX_STATIC_IFS	1
 #define DHD_DEL_IF			-0xE
 #define DHD_BAD_IF			-0xF
 #define DHD_DUMMY_INFO_IF	0xDEAF	/* Hack i/f to handle events from INFO Ring */
 /* to avoid build error for NDIS for timebeing */
 #define DHD_EVENT_IF DHD_DUMMY_INFO_IF

 #if defined(__linux__)
 enum dhd_op_flags {
 /* Firmware requested operation mode */
 	DHD_FLAG_STA_MODE				= (1 << (0)), /* STA only */
 	DHD_FLAG_HOSTAP_MODE				= (1 << (1)), /* SOFTAP only */
 	DHD_FLAG_P2P_MODE				= (1 << (2)), /* P2P Only */
 	/* STA + P2P */
 	DHD_FLAG_CONCURR_SINGLE_CHAN_MODE = (DHD_FLAG_STA_MODE | DHD_FLAG_P2P_MODE),
 	/* STA + SoftAP */
 	DHD_FLAG_CONCURR_STA_HOSTAP_MODE = (DHD_FLAG_STA_MODE | DHD_FLAG_HOSTAP_MODE),
 	/* MULTI_CHAN mode is meaningful only if it is conccurncy mode */
 	DHD_FLAG_CONCURR_MULTI_CHAN_MODE		= (1 << (4)), /* STA + P2P */
 	/* Current P2P mode for P2P connection */
 	DHD_FLAG_P2P_GC_MODE				= (1 << (5)),
 	DHD_FLAG_P2P_GO_MODE				= (1 << (6)),
 	DHD_FLAG_MBSS_MODE				= (1 << (7)), /* MBSS in future */
 	DHD_FLAG_IBSS_MODE				= (1 << (8)),
 	DHD_FLAG_MFG_MODE				= (1 << (9)),
 	DHD_FLAG_RSDB_MODE				= (1 << (10)),
 	DHD_FLAG_MP2P_MODE				= (1 << (11))
 };
 #endif /* defined(__linux__) */

 #define DHD_OPMODE_SUPPORTED(dhd, opmode_flag) \
 	(dhd ? ((((dhd_pub_t *)dhd)->op_mode)  &  opmode_flag) : -1)
 #define DHD_OPMODE_STA_SOFTAP_CONCURR(dhd) \
 	(dhd ? (((((dhd_pub_t *)dhd)->op_mode) & DHD_FLAG_CONCURR_STA_HOSTAP_MODE) == \
 	DHD_FLAG_CONCURR_STA_HOSTAP_MODE) : 0)

 /* Max sequential TX/RX Control timeouts to set HANG event */
 #ifndef MAX_CNTL_TX_TIMEOUT
 #define MAX_CNTL_TX_TIMEOUT 2
 #endif /* MAX_CNTL_TX_TIMEOUT */
 #ifndef MAX_CNTL_RX_TIMEOUT
 #define MAX_CNTL_RX_TIMEOUT 1
 #endif /* MAX_CNTL_RX_TIMEOUT */

 #define DHD_SCAN_ASSOC_ACTIVE_TIME	40 /* ms: Embedded default Active setting from DHD */
 #ifndef CUSTOM_SCAN_UNASSOC_ACTIVE_TIME
 #define DHD_SCAN_UNASSOC_ACTIVE_TIME	80 /* ms: Embedded def. Unassoc Active setting from DHD */
 #else
 #define DHD_SCAN_UNASSOC_ACTIVE_TIME	CUSTOM_SCAN_UNASSOC_ACTIVE_TIME
 #endif /* CUSTOM_SCAN_UNASSOC_ACTIVE_TIME */
 #define DHD_SCAN_HOME_TIME		45 /* ms: Embedded default Home time setting from DHD */
 #ifndef CUSTOM_SCAN_HOME_AWAY_TIME
 #define DHD_SCAN_HOME_AWAY_TIME	100 /* ms: Embedded default Home Away time setting from DHD */
 #else
 #define DHD_SCAN_HOME_AWAY_TIME CUSTOM_SCAN_HOME_AWAY_TIME /* ms: Custom setting from DHD */
 #endif /* CUSTOM_SCAN_HOME_AWAY_TIME */
 #ifndef CUSTOM_SCAN_PASSIVE_TIME
 #define DHD_SCAN_PASSIVE_TIME		130 /* ms: Embedded default Passive setting from DHD */
 #else
 #define DHD_SCAN_PASSIVE_TIME	CUSTOM_SCAN_PASSIVE_TIME /* ms: Custom Passive setting from DHD */
 #endif /* CUSTOM_SCAN_PASSIVE_TIME */

 #ifndef POWERUP_MAX_RETRY
 #define POWERUP_MAX_RETRY	3 /* how many times we retry to power up the chip */
 #endif
 #ifndef POWERUP_WAIT_MS
 #define POWERUP_WAIT_MS		2000 /* ms: time out in waiting wifi to come up */
 #endif
 /*
  * MAX_NVRAMBUF_SIZE determines the size of the Buffer in the DHD that holds
  * the NVRAM data. That is the size of the buffer pointed by bus->vars
  * This also needs to be increased if NVRAM files size increases
  */
 #define MAX_NVRAMBUF_SIZE	(48 * 1024) /* max nvram buf size */
 #define MAX_CLM_BUF_SIZE	(64 * 1024) /* max clm blob size */
 #define MAX_TXCAP_BUF_SIZE	(16 * 1024) /* max txcap blob size */
 #ifdef DHD_DEBUG
 #define DHD_JOIN_MAX_TIME_DEFAULT 10000 /* ms: Max time out for joining AP */
 #define DHD_SCAN_DEF_TIMEOUT 10000 /* ms: Max time out for scan in progress */
 #endif /* DHD_DEBUG */

 /* Enable Flow ring pre-memory allocation by default */
 #define FLOW_RING_PREALLOC

 #ifndef CONFIG_BCMDHD_CLM_PATH
 #ifdef OEM_ANDROID
 #if defined(CUSTOMER_HW4) && defined(PLATFORM_SLP)
 #define CONFIG_BCMDHD_CLM_PATH "/lib/firmware/bcmdhd_clm.blob"
 #else
 #define CONFIG_BCMDHD_CLM_PATH "/etc/wifi/bcmdhd_clm.blob"
 #endif /* CUSTOMER_HW4 && PLATFORM_SLP */
 #elif defined(__linux__)
 #define CONFIG_BCMDHD_CLM_PATH "/var/run/bcmdhd_clm.blob"
 #else
 /* clm download will fail on empty path */
 #define CONFIG_BCMDHD_CLM_PATH ""
 #endif /* OEM_ANDROID */
 #endif /* CONFIG_BCMDHD_CLM_PATH */

 #ifndef CONFIG_BCMDHD_TXCAP_PATH
 #define CONFIG_BCMDHD_TXCAP_PATH "/etc/wifi/bcmdhd_txcap.blob"
 #endif /* CONFIG_BCMDHD_TXCAP_PATH */

 #define WL_CCODE_NULL_COUNTRY  "#n"

 #ifndef DHD_FW_NAME
 #define DHD_FW_NAME "fw_bcmdhd.bin"
 #endif
 #ifndef DHD_NVRAM_NAME
 #define DHD_NVRAM_NAME "bcmdhd.cal"
 #endif
 #ifndef DHD_CLM_NAME
 #define DHD_CLM_NAME "bcmdhd_clm.blob"
 #endif
 #ifndef DHD_MAP_NAME
 #define DHD_MAP_NAME "fw_bcmdhd.map"
 #endif
 #ifndef DHD_TXCAP_NAME
 #define DHD_TXCAP_NAME "bcmdhd_txcap.blob"
 #endif

 #ifdef DHD_EFI
 #define FW_VER_STR_LEN	256
 #else
 #define FW_VER_STR_LEN	128
 #endif
 #define FWID_STR_LEN 256
 #define CLM_VER_STR_LEN 128
 #define BUS_API_REV_STR_LEN	128
 #define FW_VER_STR "Version"
 #define FWID_STR_1 "FWID: 01-"
 #define FWID_STR_2 "FWID=01-"
 extern char bus_api_revision[];

 enum dhd_bus_wake_state {
 	WAKE_LOCK_OFF			= 0,
 	WAKE_LOCK_PRIV			= 1,
 	WAKE_LOCK_DPC			= 2,
 	WAKE_LOCK_IOCTL			= 3,
 	WAKE_LOCK_DOWNLOAD		= 4,
 	WAKE_LOCK_TMOUT			= 5,
 	WAKE_LOCK_WATCHDOG		= 6,
 	WAKE_LOCK_LINK_DOWN_TMOUT	= 7,
 	WAKE_LOCK_PNO_FIND_TMOUT	= 8,
 	WAKE_LOCK_SOFTAP_SET		= 9,
 	WAKE_LOCK_SOFTAP_STOP		= 10,
 	WAKE_LOCK_SOFTAP_START		= 11,
 	WAKE_LOCK_SOFTAP_THREAD		= 12
 };

 enum {
 	EVENT_BUF_POOL_LOW = 32,
 	EVENT_BUF_POOL_MEDIUM = 64,
 	EVENT_BUF_POOL_HIGH = 128,
 	EVENT_BUF_POOL_HIGHEST = 256
 };

 #ifdef PCIE_INB_DW
 enum dhd_bus_ds_state {
 	DW_DEVICE_DS_INVALID		= -1,
 	DW_DEVICE_DS_DEV_SLEEP		= 0,
 	DW_DEVICE_DS_DEV_SLEEP_PEND	= 1,
 	DW_DEVICE_DS_DISABLED_WAIT	= 2,
 	DW_DEVICE_DS_DEV_WAKE		= 3,
 	DW_DEVICE_DS_ACTIVE		= 4,
 	DW_DEVICE_HOST_SLEEP_WAIT	= 5,
 	DW_DEVICE_HOST_SLEEP		= 6,
 	DW_DEVICE_HOST_WAKE_WAIT	= 7,
 	DW_DEVICE_DS_D3_INFORM_WAIT	= 8
 };
 #endif /* PCIE_INB_DW */

 enum dhd_prealloc_index {
 	DHD_PREALLOC_PROT			= 0,
 	DHD_PREALLOC_RXBUF			= 1,
 	DHD_PREALLOC_DATABUF			= 2,
 	DHD_PREALLOC_OSL_BUF			= 3,
 	/* 4 */
 	DHD_PREALLOC_WIPHY_ESCAN0		= 5,
 	DHD_PREALLOC_WIPHY_ESCAN1		= 6,
 	DHD_PREALLOC_DHD_INFO			= 7,
 	DHD_PREALLOC_DHD_WLFC_INFO		= 8,
 	DHD_PREALLOC_IF_FLOW_LKUP		= 9,
 	/* 10 */
 	DHD_PREALLOC_MEMDUMP_RAM		= 11,
 	DHD_PREALLOC_DHD_WLFC_HANGER		= 12,
 	DHD_PREALLOC_PKTID_MAP			= 13,	/* Deprecated */
 	DHD_PREALLOC_PKTID_MAP_IOCTL		= 14,	/* Deprecated */
 	DHD_PREALLOC_DHD_LOG_DUMP_BUF		= 15,
 	DHD_PREALLOC_DHD_LOG_DUMP_BUF_EX	= 16,
 	DHD_PREALLOC_DHD_PKTLOG_DUMP_BUF	= 17	/* Deprecated */
 };

 enum dhd_dongledump_mode {
 	DUMP_DISABLED		= 0,
 	DUMP_MEMONLY		= 1,
 	DUMP_MEMFILE		= 2,
 	DUMP_MEMFILE_BUGON	= 3,
 	DUMP_MEMFILE_MAX	= 4
 };

 #if defined(DHD_FILE_DUMP_EVENT) && defined(DHD_FW_COREDUMP)
 typedef enum dhd_dongledump_status {
 	DUMP_READY		= 0,
 	DUMP_IN_PROGRESS	= 1,
 	DUMP_FAILURE		= 2,
 	DUMP_NOT_READY		= 3
 } dhd_dongledump_status_t;
 #endif /* DHD_FILE_DUMP_EVENT && DHD_FW_COREDUMP */

 enum dhd_dongledump_type {
 	DUMP_TYPE_CLEAR				= 0,
 	DUMP_TYPE_RESUMED_ON_TIMEOUT		= 1,
 	DUMP_TYPE_D3_ACK_TIMEOUT		= 2,
 	DUMP_TYPE_DONGLE_TRAP			= 3,
 	DUMP_TYPE_MEMORY_CORRUPTION		= 4,
 	DUMP_TYPE_PKTID_AUDIT_FAILURE		= 5,
 	DUMP_TYPE_PKTID_INVALID			= 6,
 	DUMP_TYPE_SCAN_TIMEOUT			= 7,
 	DUMP_TYPE_SCAN_BUSY			= 8,
 	DUMP_TYPE_BY_SYSDUMP			= 9,
 	DUMP_TYPE_BY_LIVELOCK			= 10,
 	DUMP_TYPE_AP_LINKUP_FAILURE		= 11,
 	DUMP_TYPE_AP_ABNORMAL_ACCESS		= 12,
 	DUMP_TYPE_CFG_VENDOR_TRIGGERED		= 13,
 	DUMP_TYPE_RESUMED_ON_TIMEOUT_TX		= 14,
 	DUMP_TYPE_RESUMED_ON_TIMEOUT_RX		= 15,
 	DUMP_TYPE_RESUMED_ON_INVALID_RING_RDWR	= 16,
 	DUMP_TYPE_TRANS_ID_MISMATCH		= 17,
 	DUMP_TYPE_IFACE_OP_FAILURE		= 18,
 	DUMP_TYPE_DONGLE_INIT_FAILURE		= 19,
 	DUMP_TYPE_READ_SHM_FAIL			= 20,
 	DUMP_TYPE_DONGLE_HOST_EVENT		= 21,
 	DUMP_TYPE_SMMU_FAULT			= 22,
 	DUMP_TYPE_RESUMED_UNKNOWN		= 23,
 	DUMP_TYPE_DUE_TO_BT			= 24,
 	DUMP_TYPE_LOGSET_BEYOND_RANGE		= 25,
 	DUMP_TYPE_BY_USER			= 26,
 	DUMP_TYPE_CTO_RECOVERY			= 27,
 	DUMP_TYPE_SEQUENTIAL_PRIVCMD_ERROR	= 28,
 	DUMP_TYPE_PROXD_TIMEOUT			= 29,
 	DUMP_TYPE_INBAND_DEVICE_WAKE_FAILURE	= 30,
 	DUMP_TYPE_PKTID_POOL_DEPLETED		= 31,
 	DUMP_TYPE_INVALID_SHINFO_NRFRAGS	= 32,
 	DUMP_TYPE_P2P_DISC_BUSY			= 33,
 	DUMP_TYPE_CONT_EXCESS_PM_AWAKE		= 34,
 	DUMP_TYPE_NO_DB7_ACK			= 35,
 	DUMP_TYPE_DONGLE_TRAP_DURING_WIFI_ONOFF	= 36,
 	DUMP_TYPE_ESCAN_SYNCID_MISMATCH		= 37,
 	DUMP_TYPE_COREDUMP_BY_USER		= 38,
 	DUMP_TYPE_WL_BP_DOWN			= 39,
 	DUMP_TYPE_COMMON_BP_DOWN		= 40,
 	DUMP_TYPE_COEXCPU_BP_DOWN		= 41
 };

 enum dhd_hang_reason {
 	HANG_REASON_MASK				= 0x8000,
 	HANG_REASON_IOCTL_RESP_TIMEOUT			= 0x8001,
 	HANG_REASON_DONGLE_TRAP				= 0x8002,
 	HANG_REASON_D3_ACK_TIMEOUT			= 0x8003,
 	HANG_REASON_BUS_DOWN				= 0x8004,
 	HANG_REASON_MSGBUF_LIVELOCK			= 0x8006,
 	HANG_REASON_IFACE_DEL_FAILURE			= 0x8007,
 	HANG_REASON_HT_AVAIL_ERROR			= 0x8008,
 	HANG_REASON_PCIE_RC_LINK_UP_FAIL		= 0x8009,
 	HANG_REASON_PCIE_PKTID_ERROR			= 0x800A,
 	HANG_REASON_IFACE_ADD_FAILURE			= 0x800B,
 	HANG_REASON_IOCTL_RESP_TIMEOUT_SCHED_ERROR	= 0x800C,
 	HANG_REASON_D3_ACK_TIMEOUT_SCHED_ERROR		= 0x800D,
 	HANG_REASON_SEQUENTIAL_PRIVCMD_ERROR		= 0x800E,
 	HANG_REASON_SCAN_BUSY				= 0x800F,
 	HANG_REASON_BSS_UP_FAILURE			= 0x8010,
 	HANG_REASON_BSS_DOWN_FAILURE			= 0x8011,
 	HANG_REASON_IOCTL_SUSPEND_ERROR			= 0x8012,
 	HANG_REASON_ESCAN_SYNCID_MISMATCH               = 0x8013,
 	HANG_REASON_SCAN_TIMEOUT			= 0x8014,
 	HANG_REASON_SCAN_TIMEOUT_SCHED_ERROR		= 0x8015,
 	HANG_REASON_P2P_DISC_BUSY			= 0x8016,
 	HANG_REASON_PCIE_LINK_DOWN_RC_DETECT		= 0x8805,
 	HANG_REASON_INVALID_EVENT_OR_DATA		= 0x8806,
 	HANG_REASON_UNKNOWN				= 0x8807,
 	HANG_REASON_PCIE_LINK_DOWN_EP_DETECT		= 0x8808,
 	HANG_REASON_PCIE_CTO_DETECT			= 0x8809,
 	HANG_REASON_SLEEP_FAILURE			= 0x880A,
 	HANG_REASON_DS_SKIP_TIMEOUT			= 0x880B,
 	HANG_REASON_IOCTL_TXNID_MISMATCH		= 0x880C,
 	HANG_REASON_MAX					= 0x880D
 };

 #define WLC_E_DEAUTH_MAX_REASON 0x0FFF

 enum dhd_rsdb_scan_features {
 	/* Downgraded scan feature for AP active */
 	RSDB_SCAN_DOWNGRADED_AP_SCAN = 0x01,
 	/* Downgraded scan feature for P2P Discovery */
 	RSDB_SCAN_DOWNGRADED_P2P_DISC_SCAN = 0x02,
 	/* Enable channel pruning for ROAM SCAN */
 	RSDB_SCAN_DOWNGRADED_CH_PRUNE_ROAM = 0x10,
 	/* Enable channel pruning for any SCAN */
 	RSDB_SCAN_DOWNGRADED_CH_PRUNE_ALL  = 0x20
 };

 #define VENDOR_SEND_HANG_EXT_INFO_LEN (800 + 1)
 #ifdef DHD_EWPR_VER2
 #define VENDOR_SEND_HANG_EXT_INFO_VER 20181111
 #else
 #define VENDOR_SEND_HANG_EXT_INFO_VER 20170905
 #endif /* DHD_EWPR_VER2 */

 #define HANG_INFO_TRAP_T_NAME_MAX 6
 #define HANG_INFO_TRAP_T_REASON_IDX 0
 #define HANG_INFO_TRAP_T_SUBTYPE_IDX 2
 #define HANG_INFO_TRAP_T_OFFSET_IDX 3
 #define HANG_INFO_TRAP_T_EPC_IDX 4
 #define HANG_FIELD_STR_MAX_LEN 9
 #define HANG_FIELD_CNT_MAX 69
 #define HANG_FIELD_IF_FAILURE_CNT 10
 #define HANG_FIELD_IOCTL_RESP_TIMEOUT_CNT 8
 #define HANG_FIELD_TRAP_T_STACK_CNT_MAX 16
 #define HANG_FIELD_MISMATCH_CNT 10
 #define HANG_INFO_BIGDATA_KEY_STACK_CNT 4

 #define DEBUG_DUMP_TIME_BUF_LEN (16 + 1)
 /* delimiter between values */
 #define HANG_KEY_DEL    ' '
 #define HANG_RAW_DEL    '_'

 #ifdef DHD_EWPR_VER2
 #define HANG_INFO_BIGDATA_EXTRA_KEY 4
 #define HANG_INFO_TRAP_T_EXTRA_KEY_IDX 5
 #endif

 /* Packet alignment for most efficient SDIO (can change based on platform) */
 #ifndef DHD_SDALIGN
 #define DHD_SDALIGN	32
 #endif

 #define DHD_TX_CONTEXT_MASK 0xff
 #define DHD_TX_START_XMIT   0x01
 #define DHD_TX_SEND_PKT     0x02
 #define DHD_IF_SET_TX_ACTIVE(ifp, context)	\
     ifp->tx_paths_active |= context;
 #define DHD_IF_CLR_TX_ACTIVE(ifp, context)	\
     ifp->tx_paths_active &= ~context;
 #define DHD_IF_IS_TX_ACTIVE(ifp)	\
 	(ifp->tx_paths_active)
 /**
  * DMA-able buffer parameters
  * - dmaaddr_t is 32bits on a 32bit host.
  *   dhd_dma_buf::pa may not be used as a sh_addr_t, bcm_addr64_t or uintptr
  * - dhd_dma_buf::_alloced is ONLY for freeing a DMA-able buffer.
  */
 typedef struct dhd_dma_buf {
 	void      *va;      /* virtual address of buffer */
 	uint32    len;      /* user requested buffer length */
 	dmaaddr_t pa;       /* physical address of buffer */
 	void      *dmah;    /* dma mapper handle */
 	void      *secdma;  /* secure dma sec_cma_info handle */
 	uint32    _alloced; /* actual size of buffer allocated with align and pad */
 } dhd_dma_buf_t;

 /* host reordering packts logic */
 /* followed the structure to hold the reorder buffers (void **p) */
 typedef struct reorder_info {
 	void **p;
 	uint8 flow_id;
 	uint8 cur_idx;
 	uint8 exp_idx;
 	uint8 max_idx;
 	uint8 pend_pkts;
 } reorder_info_t;

 /* throughput test packet format */
 typedef struct tput_pkt {
 	/* header */
 	uint8 mac_sta[ETHER_ADDR_LEN];
 	uint8 mac_ap[ETHER_ADDR_LEN];
 	uint16 pkt_type;
 	uint8 PAD[2];
 	/* data */
 	uint32 crc32;
 	uint32 pkt_id;
 	uint32 num_pkts;
 } tput_pkt_t;

 typedef enum {
 	TPUT_PKT_TYPE_NORMAL,
 	TPUT_PKT_TYPE_STOP
 } tput_pkt_type_t;

 #define TPUT_TEST_MAX_PAYLOAD 1500
 #define TPUT_TEST_WAIT_TIMEOUT_DEFAULT 5000

 #ifdef DHDTCPACK_SUPPRESS

 enum {
 	/* TCPACK suppress off */
 	TCPACK_SUP_OFF,
 	/* Replace TCPACK in txq when new coming one has higher ACK number. */
 	TCPACK_SUP_REPLACE,
 	/* TCPACK_SUP_REPLACE + delayed TCPACK TX unless ACK to PSH DATA.
 	 * This will give benefits to Half-Duplex bus interface(e.g. SDIO) that
 	 * 1. we are able to read TCP DATA packets first from the bus
 	 * 2. TCPACKs that don't need to hurry delivered remains longer in TXQ so can be suppressed.
 	 */
 	TCPACK_SUP_DELAYTX,
 	TCPACK_SUP_HOLD,
 	TCPACK_SUP_LAST_MODE
 };
 #endif /* DHDTCPACK_SUPPRESS */

 #if defined(BCM_ROUTER_DHD)
 #define DHD_DWM_TBL_SIZE           57
 /* DSCP WMM AC Mapping macros and structures */
 #define DHD_TRF_MGMT_DWM_FILTER_BIT                 0x8
 #define DHD_TRF_MGMT_DWM_PRIO_BITS                  0x7
 #define DHD_TRF_MGMT_DWM_FAVORED_BIT                0x10
 #define DHD_TRF_MGMT_DWM_PRIO(dwm_tbl_entry) ((dwm_tbl_entry) & DHD_TRF_MGMT_DWM_PRIO_BITS)
 #define DHD_TRF_MGMT_DWM_IS_FAVORED_SET(dwm_tbl_entry) \
 	((dwm_tbl_entry) & DHD_TRF_MGMT_DWM_FAVORED_BIT)
 #define DHD_TRF_MGMT_DWM_SET_FAVORED(dwm_tbl_entry) \
 	((dwm_tbl_entry) |= DHD_TRF_MGMT_DWM_FAVORED_BIT)
 #define DHD_TRF_MGMT_DWM_IS_FILTER_SET(dwm_tbl_entry) \
 	((dwm_tbl_entry) & DHD_TRF_MGMT_DWM_FILTER_BIT)
 #define DHD_TRF_MGMT_DWM_SET_FILTER(dwm_tbl_entry) \
 	((dwm_tbl_entry) |= DHD_TRF_MGMT_DWM_FILTER_BIT)

 typedef struct {
 	uint8 dhd_dwm_enabled;
 	uint8 dhd_dwm_tbl[DHD_DWM_TBL_SIZE];
 } dhd_trf_mgmt_dwm_tbl_t;
 #endif /* for BCM_ROUTER_DHD */

 #define DHD_NULL_CHK_AND_RET(cond) \
 	if (!cond) { \
 		DHD_ERROR(("%s " #cond " is NULL\n", __FUNCTION__)); \
 		return; \
 	}

 #define DHD_NULL_CHK_AND_RET_VAL(cond, value) \
 	if (!cond) { \
 		DHD_ERROR(("%s " #cond " is NULL\n", __FUNCTION__)); \
 		return value; \
 	}

 #define DHD_NULL_CHK_AND_GOTO(cond, label) \
 	if (!cond) { \
 		DHD_ERROR(("%s " #cond " is NULL\n", __FUNCTION__)); \
 		goto label; \
 	}

 /*
  * Accumulating the queue lengths of all flowring queues in a parent object,
  * to assert flow control, when the cummulative queue length crosses an upper
  * threshold defined on a parent object. Upper threshold may be maintained
  * at a station level, at an interface level, or at a dhd instance.
  *
  * cumm_ctr_t abstraction:
  * cumm_ctr_t abstraction may be enhanced to use an object with a hysterisis
  * pause on/off threshold callback.
  * All macros use the address of the cummulative length in the parent objects.
  *
  * Cummulative counters in parent objects may be updated without spinlocks.
  *
  * If a cummulative queue length is desired across all flows
  * belonging to either of (a station, or an interface or a dhd instance), then
  * an atomic operation is required using an atomic_t cummulative counters or
  * using a spinlock. BCM_ROUTER_DHD uses the Linux atomic_t construct.
  */
 #if defined(BCM_ROUTER_DHD)

 typedef atomic_t cumm_ctr_t;       /* BCM_ROUTER_DHD Linux: atomic operations */
 #define DHD_CUMM_CTR_PTR(clen)     ((cumm_ctr_t*)(clen))
 #define DHD_CUMM_CTR(clen)         DHD_CUMM_CTR_PTR(clen) /* atomic accessor */
 #define DHD_CUMM_CTR_READ(clen)    atomic_read(DHD_CUMM_CTR(clen)) /* read */
 #define DHD_CUMM_CTR_INIT(clen)                                                \
 	ASSERT(DHD_CUMM_CTR_PTR(clen) != DHD_CUMM_CTR_PTR(NULL));                  \
 	atomic_set(DHD_CUMM_CTR(clen), 0);
 #define DHD_CUMM_CTR_INCR(clen)                                                \
 	ASSERT(DHD_CUMM_CTR_PTR(clen) != DHD_CUMM_CTR_PTR(NULL));                  \
 	atomic_add(1, DHD_CUMM_CTR(clen));                                         \
 	ASSERT(DHD_CUMM_CTR_READ(clen) != 0); /* ensure it does not wrap */
 #define DHD_CUMM_CTR_DECR(clen)                                                \
 	ASSERT(DHD_CUMM_CTR_PTR(clen) != DHD_CUMM_CTR_PTR(NULL));                  \
 	ASSERT(DHD_CUMM_CTR_READ(clen) > 0);                                       \
 	atomic_sub(1, DHD_CUMM_CTR(clen));

 #else  /* ! BCM_ROUTER_DHD */

 /* Cummulative length not supported. */
 typedef uint32 cumm_ctr_t;
 #define DHD_CUMM_CTR_PTR(clen)     ((cumm_ctr_t*)(clen))
 #define DHD_CUMM_CTR(clen)         *(DHD_CUMM_CTR_PTR(clen)) /* accessor */
 #define DHD_CUMM_CTR_READ(clen)    DHD_CUMM_CTR(clen) /* read access */
 #define DHD_CUMM_CTR_INIT(clen)                                                \
 	ASSERT(DHD_CUMM_CTR_PTR(clen) != DHD_CUMM_CTR_PTR(NULL));
 #define DHD_CUMM_CTR_INCR(clen)                                                \
 	ASSERT(DHD_CUMM_CTR_PTR(clen) != DHD_CUMM_CTR_PTR(NULL));
 #define DHD_CUMM_CTR_DECR(clen)                                                \
 	ASSERT(DHD_CUMM_CTR_PTR(clen) != DHD_CUMM_CTR_PTR(NULL));

 #endif /* ! BCM_ROUTER_DHD */

 #if defined(WLTDLS) && defined(PCIE_FULL_DONGLE)
 struct tdls_peer_node {
 	uint8 addr[ETHER_ADDR_LEN];
 	struct tdls_peer_node *next;
 };
 typedef struct tdls_peer_node tdls_peer_node_t;
 typedef struct {
 	tdls_peer_node_t *node;
 	uint8 tdls_peer_count;
 } tdls_peer_tbl_t;
 #endif /* defined(WLTDLS) && defined(PCIE_FULL_DONGLE) */

 typedef enum dhd_ring_id {
 	DEBUG_RING_ID_INVALID = 0x1,
 	FW_VERBOSE_RING_ID = 0x2,
 	DHD_EVENT_RING_ID = 0x3,
 	DRIVER_LOG_RING_ID = 0x4,
 	ROAM_STATS_RING_ID = 0x5,
 	BT_LOG_RING_ID = 0x6,
 	PACKET_LOG_RING_ID = 0x7,
 	DEBUG_DUMP_RING1_ID = 0x8,
 	DEBUG_DUMP_RING2_ID = 0x9,
 	MEM_DUMP_RING_ID = 0xa,
 	ECNTRS_RING_ID = 0xb,
 	DEBUG_RING_ID_MAX = 0xc
 } dhd_ring_id_t;

 #define DHD_PCIE_WRAPPER_LEN (20 * 1024)

 #define HEALTH_CHK_BUF_SIZE 256

 /* DEBUG_DUMP SUB COMMAND */
 enum {
 	CMD_DEFAULT,
 	CMD_UNWANTED,
 	CMD_DISCONNECTED,
 	CMD_MAX
 };

 #define DHD_DUMP_SUBSTR_UNWANTED	"_unwanted"
 #define DHD_DUMP_SUBSTR_DISCONNECTED	"_disconnected"

 #ifdef DNGL_AXI_ERROR_LOGGING
 #define DHD_DUMP_AXI_ERROR_FILENAME	"axi_error"
 #define DHD_DUMP_HAL_FILENAME_SUFFIX	"_hal"
 #endif /* DNGL_AXI_ERROR_LOGGING */

 #define FW_LOGSET_MASK_ALL 0xFFFFu

 #ifndef DHD_COMMON_DUMP_PATH
 #if defined(CUSTOMER_HW4)
 #define DHD_COMMON_DUMP_PATH	"/data/log/wifi/"
 #elif defined(CUSTOMER_HW2_DEBUG)
 #define DHD_COMMON_DUMP_PATH    PLATFORM_PATH
 #elif defined(BOARD_HIKEY) || defined (BOARD_STB)
 #ifndef DHD_COMMON_DUMP_PATH
 #define DHD_COMMON_DUMP_PATH	"/data/misc/wifi/"
 #endif /* !DHD_COMMON_DUMP_PATH */
 #elif defined(OEM_ANDROID) && defined(__ARM_ARCH_7A__)
 #define DHD_COMMON_DUMP_PATH	"/data/vendor/wifi/"
 #elif defined(OEM_ANDROID) /* For Brix Live Image */
 #define DHD_COMMON_DUMP_PATH	"/installmedia/"
 #else /* Default */
 #define DHD_COMMON_DUMP_PATH	"/root/"
 #endif /* CUSTOMER_HW4 */
 #endif /* !DHD_COMMON_DUMP_PATH */

 #define DHD_MEMDUMP_LONGSTR_LEN 192u

 struct cntry_locales_custom {
 	char iso_abbrev[WLC_CNTRY_BUF_SZ];      /* ISO 3166-1 country abbreviation */
 	char custom_locale[WLC_CNTRY_BUF_SZ];   /* Custom firmware locale */
 	int32 custom_locale_rev;                /* Custom local revisin default -1 */
 };

 #ifdef __linux__
 extern uint16 dhd_plat_align_rxbuf_size(uint16 rxbufpost_sz);
 #else
 static INLINE uint16 dhd_plat_align_rxbuf_size(uint16 rxbufpost_sz) { return rxbufpost_sz; }
 #endif /* __linux__ */


 #if defined(__linux__)
 int dhd_send_msg_to_daemon(struct sk_buff *skb, void *data, int size);
 #endif /* __linux__ */
 #ifdef REPORT_FATAL_TIMEOUTS
 typedef struct timeout_info {
 	void	*scan_timer_lock;
 	void	*join_timer_lock;
 	void	*cmd_timer_lock;
 	void	*bus_timer_lock;
 	uint32 scan_timeout_val;
 	uint32 join_timeout_val;
 	uint32 cmd_timeout_val;
 	uint32 bus_timeout_val;
 	bool scan_timer_active;
 	bool join_timer_active;
 	bool cmd_timer_active;
 	bool bus_timer_active;
 	osl_timer_t *scan_timer;
 	osl_timer_t *join_timer;
 	osl_timer_t *cmd_timer;
 	osl_timer_t *bus_timer;
 	uint32 cmd_request_id;
 	uint32 cmd;
 	uint32 cmd_join_error;
 	uint16 escan_syncid;
 	bool escan_aborted;
 	uint16 abort_syncid;
 } timeout_info_t;
 #endif /* REPORT_FATAL_TIMEOUTS */

 #ifdef DMAMAP_STATS
 typedef struct dmamap_stats {
 	uint64 txdata;
 	uint64 txdata_sz;
 	uint64 rxdata;
 	uint64 rxdata_sz;
 	uint64 ioctl_rx;
 	uint64 ioctl_rx_sz;
 	uint64 event_rx;
 	uint64 event_rx_sz;
 	uint64 info_rx;
 	uint64 info_rx_sz;
 	uint64 tsbuf_rx;
 	uint64 tsbuf_rx_sz;
 } dma_stats_t;
 #endif /* DMAMAP_STATS */

 #ifdef BT_OVER_PCIE
 enum dhd_bus_quiesce_state {
 	DHD_QUIESCE_INIT = 0,
 	REQUEST_BT_QUIESCE = 1,
 	RESPONSE_BT_QUIESCE = 2,
 	REQUEST_BT_RESUME = 3,
 	RESPONSE_BT_RESUME = 4
 };
 #endif /* BT_OVER_PCIE */

 /*  see wlfc_proto.h for tx status details */
 #define DHD_MAX_TX_STATUS_MSGS     11u

 #ifdef TX_STATUS_LATENCY_STATS
 typedef struct dhd_if_tx_status_latency {
 	/* total number of tx_status received on this interface */
 	uint64 num_tx_status;
 	/* cumulative tx_status latency for this interface */
 	uint64 cum_tx_status_latency;
 } dhd_if_tx_status_latency_t;
 #endif /* TX_STATUS_LATENCY_STATS */


 /* Bit in dhd_pub_t::gdb_proxy_stop_count set when firmware is stopped by GDB */
 #define GDB_PROXY_STOP_MASK 1

 /* Enable Reserve STA flowrings only for Android */

 #if defined(OEM_ANDROID)
 #define DHD_LIMIT_MULTI_CLIENT_FLOWRINGS
 #endif /* OEM_ANDROID */

 typedef enum {
 	FW_UNLOADED = 0,
 	FW_DOWNLOAD_IN_PROGRESS = 1,
 	FW_DOWNLOAD_DONE = 2
 } fw_download_status_t;

 #ifdef BCMINTERNAL

 #ifdef DHD_FWTRACE
 typedef struct fwtrace_info fwtrace_info_t; /* forward declaration */
 #endif	/* DHD_FWTRACE */

 #endif	/* BCMINTERNAL */

 typedef enum dhd_induce_error_states
 {
 	DHD_INDUCE_ERROR_CLEAR		= 0x0,
 	DHD_INDUCE_IOCTL_TIMEOUT	= 0x1,
 	DHD_INDUCE_D3_ACK_TIMEOUT	= 0x2,
 	DHD_INDUCE_LIVELOCK		= 0x3,
 	DHD_INDUCE_DROP_OOB_IRQ		= 0x4,
 	DHD_INDUCE_DROP_AXI_SIG		= 0x5,
 	DHD_INDUCE_IOCTL_SUSPEND_ERROR	= 0x6,
 	DHD_INDUCE_TX_BIG_PKT		= 0x7,
 	DHD_INDUCE_SCAN_TIMEOUT		= 0x8,
 	DHD_INDUCE_SCAN_TIMEOUT_SCHED_ERROR = 0x9,
 	DHD_INDUCE_PKTID_INVALID_SAVE = 0xA,
 	DHD_INDUCE_PKTID_INVALID_FREE = 0xB,
 	DHD_INDUCE_PCIE_LINK_DOWN	= 0xC,
 	/* Big hammer induction */
 	DHD_INDUCE_BH_ON_FAIL_ONCE	= 0x10,
 	DHD_INDUCE_BH_ON_FAIL_ALWAYS	= 0x11,
 	DHD_INDUCE_BH_CBP_HANG		= 0x12,
 	DHD_INDUCE_P2P_DISC_BUSY	= 0x13,
 	DHD_INDUCE_PCIE_LINK_DOWN_IN_ISR	= 0x14,
 	DHD_INDUCE_ERROR_MAX
 } dhd_induce_error_states_t;

 #define MAX_MDRING_ITEM_DUMP	64

 #ifdef DHD_HP2P
 #define MAX_TX_HIST_BIN		16u
 #define MAX_RX_HIST_BIN		16u
 #define MAX_HP2P_FLOWS		16
 #define HP2P_PRIO		7
 #define HP2P_PKT_THRESH		48
 #define HP2P_TIME_THRESH	200
 #define HP2P_PKT_EXPIRY		40
 #define	HP2P_TIME_SCALE		32
 #define HP2P_HIST_BIN_WIDTH	2u
 #define HP2P_DURATION_MASK	0x3FFu
 #define HP2P_DURATION1_OFFS	10u
 #define HP2P_DURATION2_OFFS	20u
 #define HP2P_CAP_DURATION_MASK	7u
 #define HP2P_CAP_DURATION_SHIFT	3u

 typedef struct hp2p_info {
 	void	*dhd_pub;
 	uint16	flowid;
 	bool	hrtimer_init;
 	void	*ring;
 	struct	hrtimer timer;
 	uint64	num_pkt_limit;
 	uint64	num_timer_limit;
 	uint64	num_timer_start;
 	uint64	tx_t0[MAX_TX_HIST_BIN];
 	uint64	tx_t1[MAX_TX_HIST_BIN];
 	uint64	tx_t2[MAX_TX_HIST_BIN];
 	uint64  rx_t0[MAX_RX_HIST_BIN];
 } hp2p_info_t;
 #endif /* DHD_HP2P */

 #define MAX_RX_LAT_PRIO		8
 #define MAX_RX_LAT_HIST_BIN	50
 #define MAX_RXCPL_HISTORY	50
 #define	RX_LAT_TIME_SCALE	32
 #define	RX_LAT_BIN_SCALE	500

 typedef struct rx_cpl_history {
 	uint32 host_time;
 	uint32 ptm_high;
 	uint32 ptm_low;
 	uint32 rx_t0;
 	uint32 rx_t1;
 	uint32 latency;
 	uint8 slice;
 	uint8 priority;
 	int8 rssi;
 	uint8 rsvd;
 	uint32 proto;
 	uint32 tuple_1;
 	uint32 tuple_2;
 } rx_cpl_history_t;

 typedef struct rx_cpl_lat_info {
 	rx_cpl_history_t rx_history[MAX_RXCPL_HISTORY];
 	uint32 rxcpl_hist_count;
 	uint32	rx_dur_2g[MAX_RX_LAT_PRIO][MAX_RX_LAT_HIST_BIN];
 	uint32	rx_dur_5g[MAX_RX_LAT_PRIO][MAX_RX_LAT_HIST_BIN];
 	uint32	rx_dur_6g[MAX_RX_LAT_PRIO][MAX_RX_LAT_HIST_BIN];
 } rx_cpl_lat_info_t;

 #define MAX_TXCPL_HISTORY	50u
 typedef struct tx_cpl_history {
 	uint32 host_time;
 	uint32 ptm_high;
 	uint32 ptm_low;
 	uint16 latency;
 	uint16 flowid;
 	uint8 tid;
 	uint8 rsvd[3];
 	uint32 proto;
 	uint32 tuple_1;
 	uint32 tuple_2;
 } tx_cpl_history_t;

 typedef struct tx_cpl_info {
 	tx_cpl_history_t tx_history[MAX_TXCPL_HISTORY];
 	uint32 txcpl_hist_count;
 } tx_cpl_info_t;

 #define DHD_PTM_CLK_ID		0xEu		/* PTM clock ID; IDs 0-3 are used in tsync module */
 #define DHD_INV_CLK_ID		0xFu		/* PTM clock ID; IDs 0-3 are used in tsync module */
 #define DHD_PTM_CLK_ID_MASK	0xF0000000u	/* Bitmask for clkid */
 #define DHD_PTM_CLK_ID_SHIFT	28u		/* Bitshift for clkid */

 #define DHD_PTM_GET_CLKID(ts) (((ts) & DHD_PTM_CLK_ID_MASK) >> DHD_PTM_CLK_ID_SHIFT)
 #define DHD_PTM_CLKID(ts) (DHD_PTM_GET_CLKID(ts) == DHD_PTM_CLK_ID)
 #define DHD_INV_CLKID(ts) (DHD_PTM_GET_CLKID(ts) == DHD_INV_CLK_ID)

 #ifdef DHD_USE_STATIC_CTRLBUF
 #define PKTFREE_CTRLBUF(osh, p, flag) PKTFREE_STATIC(osh, p, flag);
 #else
 #define PKTFREE_CTRLBUF(osh, p, flag) PKTFREE(osh, p, flag);
 #endif /* DHD_USE_STATIC_CTRLBUF */

 #define RX_PKTFREE(osh, pkt_type, p, flag) \
 do { \
 	if (ntoh16(pkt_type) == ETHER_TYPE_BRCM) { \
 		PKTFREE_CTRLBUF(osh, p, flag); \
 	} else { \
 		PKTCFREE(osh, p, flag); \
 	} \
 } while (0);

 #if defined(SHOW_LOGTRACE) && defined(DHD_USE_KTHREAD_FOR_LOGTRACE)
 /* Timestamps to trace dhd_logtrace_thread() */
 struct dhd_logtrace_thr_ts {
 	uint64 entry_time;
 	uint64 sem_down_time;
 	uint64 flush_time;
 	uint64 unexpected_break_time;
 	uint64 complete_time;
 };
 #endif /* SHOW_LOGTRACE && DHD_USE_KTHREAD_FOR_LOGTRACE */

 #ifdef SUPPORT_OTA_UPDATE
 #define MAX_EXT_INFO_LEN	10u
 typedef struct ota_update_info {
 	uint32 clm_len;
 	uint8 *clm_buf;
 	uint32 nvram_len;
 	uint8 *nvram_buf;
 	uint8 nvram_ext[MAX_EXT_INFO_LEN];
 	uint32 txcap_len;
 	uint8 *txcap_buf;
 } ota_update_info_t;
 #endif /* SUPPORT_OTA_UPDATE */

 #define PCIE_DB7_MAGIC_NUMBER_ISR_TRAP	0xdead0001
 #define PCIE_DB7_MAGIC_NUMBER_DPC_TRAP	0xdead0002
 #define PCIE_DB7_MAGIC_NUMBER_DPC_LPM	0xdead0003

 typedef struct dhd_db7_info {
 	bool	fw_db7w_trap;
 	bool	fw_db7w_trap_inprogress;
 	volatile bool	fw_db7w_trap_received;
 	uint32	db7_magic_number;

 	uint32	debug_db7_send_cnt;
 	uint32	debug_db7_trap_cnt;
 	uint32	debug_db7_timing_error_cnt;
 	uint64	debug_db7_send_time;
 	uint64	debug_db7_trap_time;
 	uint64	debug_max_db7_dur;
 	uint64	debug_max_db7_send_time;
 	uint64	debug_max_db7_trap_time;
 } dhd_db7_info_t;

 /**
  * Common structure for module and instance linkage.
  * Instantiated once per hardware (dongle) instance that this DHD manages.
  */
 typedef struct dhd_pub {
 	/* Linkage ponters */
 	osl_t *osh;		/* OSL handle */
 	struct dhd_bus *bus;	/* Bus module handle */
 	struct dhd_prot *prot;	/* Protocol module handle */
 	struct dhd_info  *info; /* Info module handle */
 	struct dhd_dbg *dbg;	/* Debugability module handle */
 	dhd_logger_t *logger;	/* DHD logger module handle */
 #if defined(SHOW_LOGTRACE) && defined(DHD_USE_KTHREAD_FOR_LOGTRACE)
 	struct dhd_logtrace_thr_ts logtrace_thr_ts;
 #endif /* SHOW_LOGTRACE && DHD_USE_KTHREAD_FOR_LOGTRACE */

 	/* to NDIS developer, the structure dhd_common is redundant,
 	 * please do NOT merge it back from other branches !!!
 	 */

 	/* Internal dhd items */
 	bool up;		/* Driver up/down (to OS) */
 #ifdef WL_CFG80211
 	spinlock_t up_lock;	/* Synchronization with CFG80211 down */
 #endif /* WL_CFG80211 */
 	bool txoff;		/* Transmit flow-controlled */
 	bool dongle_reset;  /* TRUE = DEVRESET put dongle into reset */
 	enum dhd_bus_state busstate;
 	uint dhd_bus_busy_state;	/* Bus busy state */
 	uint hdrlen;		/* Total DHD header length (proto + bus) */
 	uint maxctl;		/* Max size rxctl request from proto to bus */
 	uint rxsz;		/* Rx buffer size bus module should use */
 	uint8 wme_dp;	/* wme discard priority */
 #ifdef DNGL_AXI_ERROR_LOGGING
 	uint32 axierror_logbuf_addr;
 	bool axi_error;
 	struct dhd_axi_error_dump *axi_err_dump;
 #endif /* DNGL_AXI_ERROR_LOGGING */
 	/* Dongle media info */
 	bool iswl;		/* Dongle-resident driver is wl */
 	ulong drv_version;	/* Version of dongle-resident driver */
 	struct ether_addr mac;	/* MAC address obtained from dongle */
 	dngl_stats_t dstats;	/* Stats for dongle-based data */

 	/* Additional stats for the bus level */
 	ulong tx_packets;	/* Data packets sent to dongle */
 	ulong actual_tx_pkts;	/* Actual data packets sent to dongle */
 	ulong tot_txcpl;	/* Total Tx completion received */
 	ulong tx_dropped;	/* Data packets dropped in dhd */
 	ulong tx_multicast;	/* Multicast data packets sent to dongle */
 	ulong tx_errors;	/* Errors in sending data to dongle */
 	ulong tx_ctlpkts;	/* Control packets sent to dongle */
 	ulong tx_ctlerrs;	/* Errors sending control frames to dongle */
 	ulong rx_packets;	/* Packets sent up the network interface */
 	ulong rx_forward;	/* Packets forwarded at DHD driver level */
 	ulong rx_multicast;	/* Multicast packets sent up the network interface */
 	ulong rx_errors;	/* Errors processing rx data packets */
 	ulong rx_ctlpkts;	/* Control frames processed from dongle */
 	ulong rx_ctlerrs;	/* Errors in processing rx control frames */
 	ulong rx_dropped;	/* Packets dropped locally (no memory) */
 	ulong rx_flushed;  /* Packets flushed due to unscheduled sendup thread */
 	ulong wd_dpc_sched;   /* Number of times dhd dpc scheduled by watchdog timer */
 	ulong rx_pktgetfail; /* Number of PKTGET failures in DHD on RX */
 	ulong rx_pktgetpool_fail;	/* Number of PKTGET_POOL failures in DHD on RX */
 	ulong tx_pktgetfail; /* Number of PKTGET failures in DHD on TX */
 	ulong rx_readahead_cnt;	/* Number of packets where header read-ahead was used. */
 	ulong tx_realloc;	/* Number of tx packets we had to realloc for headroom */
 	ulong fc_packets;       /* Number of flow control pkts recvd */
 	ulong tx_big_packets;	/* Dropped data packets that are larger than MAX_MTU_SZ */
 	ulong tx_bytes;		/* total no. of bytes transmitted successfully */
 	ulong rx_bytes;		/* total no. of bytes received */
 #ifdef TX_CSO
 	ulong tx_cso_cnt;	/* Number of tx packets for which checksum is offloaded */
 	ulong tx_nocso_cnt;	/* Number of tx packets for which checksum is not offloaded */
 #endif
 #ifdef RX_CSO
 	/* Number of rx packets for which checksum has been verified by hw */
 	ulong rx_cso_cnt;
 	/* Number of rx packets for which checksum has not been verified by hw */
 	ulong rx_nocso_cnt;
 #ifdef RX_CSO_TEST
 	int rxcso_test_badcsum_type;
 #endif /* RX_CSO_TEST */
 #endif /* RX_CSO */
 #ifdef DMAMAP_STATS
 	/* DMA Mapping statistics */
 	dma_stats_t dma_stats;
 #endif /* DMAMAP_STATS */
 #ifdef WL_MONITOR
 	bool monitor_enable;
 #endif /* WL_MONITOR */
 	/* Last error return */
 	int bcmerror;
 	uint tickcnt;

 	/* Last error from dongle */
 	int dongle_error;

 	uint8 country_code[WLC_CNTRY_BUF_SZ];

 	/* Suspend disable flag and "in suspend" flag */
 	int suspend_disable_flag; /* "1" to disable all extra powersaving during suspend */
 	int in_suspend;			/* flag set to 1 when early suspend called */
 #ifdef PNO_SUPPORT
 	int pno_enable;			/* pno status : "1" is pno enable */
 	int pno_suspend;		/* pno suspend status : "1" is pno suspended */
 #endif /* PNO_SUPPORT */
 	/* DTIM skip value, default 0(or 1) means wake each DTIM
 	 * 3 means skip 2 DTIMs and wake up 3rd DTIM(9th beacon when AP DTIM is 3)
 	 */
 	int early_suspended;		/* Early suspend status */
 #if defined(PKT_FILTER_SUPPORT)
 	int dhcp_in_progress;		/* DHCP period */
 #endif /* PKT_FILTER_SUPPORT */
 	/* Pkt filter defination */
 	char * pktfilter[100];
 	int pktfilter_count;

 	wl_country_t dhd_cspec;		/* Current Locale info */
 #ifdef CUSTOM_COUNTRY_CODE
 	uint dhd_cflags;
 #endif /* CUSTOM_COUNTRY_CODE */
 #if defined(DHD_BLOB_EXISTENCE_CHECK)
 	bool is_blob;			/* Checking for existance of Blob file */
 #endif /* DHD_BLOB_EXISTENCE_CHECK */
 	bool force_country_change;
 	int	op_mode;				/* STA, HostAPD, WFD, SoftAP */

 #if defined(__linux__)

 #if defined(OEM_ANDROID)
 	struct mutex wl_start_stop_lock; /* lock/unlock for Android start/stop */
 	struct mutex wl_softap_lock;		 /* lock/unlock for any SoftAP/STA settings */
 #endif /* defined(OEM_ANDROID) */

 #endif /* defined(__linux__) */

 #ifdef NDIS
 	PDEVICE_OBJECT pdo;
 	PDEVICE_OBJECT fdo;
 	PDEVICE_OBJECT nextDeviceObj;
 #if defined(BCMWDF)
 	WDFDEVICE wdfDevice;
 #endif /* (BCMWDF)  */
 #endif /* NDIS */
 #ifdef PROP_TXSTATUS
 	bool	wlfc_enabled;
 	int	wlfc_mode;
 	void*	wlfc_state;
 	/*
 	Mode in which the dhd flow control shall operate. Must be set before
 	traffic starts to the device.
 	0 - Do not do any proptxtstatus flow control
 	1 - Use implied credit from a packet status
 	2 - Use explicit credit
 	3 - Only AMPDU hostreorder used. no wlfc.
 	*/
 	uint8	proptxstatus_mode;
 	bool	proptxstatus_txoff;
 	bool	proptxstatus_module_ignore;
 	bool	proptxstatus_credit_ignore;
 	bool	proptxstatus_txstatus_ignore;

 	bool	wlfc_rxpkt_chk;
 #ifdef LIMIT_BORROW
 	bool wlfc_borrow_allowed;
 #endif /* LIMIT_BORROW */
 	/*
 	 * implement below functions in each platform if needed.
 	 */
 	/* platform specific function whether to skip flow control */
 	bool (*skip_fc)(void * dhdp, uint8 ifx);
 	/* platform specific function for wlfc_enable and wlfc_deinit */
 	void (*plat_init)(void *dhd);
 	void (*plat_deinit)(void *dhd);
 #ifdef DHD_WLFC_THREAD
 	bool                wlfc_thread_go;
 #if defined(__linux__)
 	struct task_struct* wlfc_thread;
 	wait_queue_head_t   wlfc_wqhead;
 #else
 	#error "wlfc thread not enabled"
 #endif /* __linux__ */
 #endif /* DHD_WLFC_THREAD */
 #endif /* PROP_TXSTATUS */
 #ifdef PNO_SUPPORT
 	void *pno_state;
 #endif
 #ifdef RTT_SUPPORT
 	void *rtt_state;
 #endif
 #ifdef ROAM_AP_ENV_DETECTION
 	bool	roam_env_detection;
 #endif
 	bool	dongle_isolation;
 	bool	is_pcie_watchdog_reset;

 /* Begin - Variables to track Bus Errors */
 	bool	dongle_trap_occured;	/* flag for sending HANG event to upper layer */
 #ifdef BT_OVER_PCIE
 	bool	dongle_trap_due_to_bt; /* flag to indicate that dongle has trapped due to BT */
 #endif /* BT_OVER_PCIE */
 	bool	iovar_timeout_occured;	/* flag to indicate iovar resumed on timeout */
 	bool	invalid_shinfo_nrfrags;	/* flag to indicate invlaid shinfo nrfrags */
 	bool	is_sched_error;		/* flag to indicate timeout due to scheduling issue */
 #ifdef PCIE_FULL_DONGLE
 	bool	d3ack_timeout_occured;	/* flag to indicate d3ack resumed on timeout */
 	bool	livelock_occured;	/* flag to indicate livelock occured */
 	bool	pktid_audit_failed;	/* flag to indicate pktid audit failure */
 	bool	pktid_invalid_occured;	/* flag to indicate invalid pktid */
 #endif /* PCIE_FULL_DONGLE */
 	bool	iface_op_failed;	/* flag to indicate interface operation failed */
 	bool	scan_timeout_occurred;	/* flag to indicate scan has timedout */
 	bool	scan_busy_occurred;	/* flag to indicate scan busy occurred */
 #ifdef BT_OVER_SDIO
 	bool	is_bt_recovery_required;
 #endif
 	bool	smmu_fault_occurred;	/* flag to indicate SMMU Fault */
 	bool	p2p_disc_busy_occurred;
 	bool	dongle_trap_during_wifi_onoff;	/* flag to indicate trap during wifi on/off */
 	bool	dongle_attach_failure;		/* Dongle attach failure */
 /*
  * Add any new variables to track Bus errors above
  * this line. Also ensure that the variable is
  * cleared from dhd_clear_all_errors
  */
 /* End - Variables to track Bus Errors */

 	int   hang_was_sent;
 	int   hang_was_pending;
 	int   rxcnt_timeout;		/* counter rxcnt timeout to send HANG */
 	int   txcnt_timeout;		/* counter txcnt timeout to send HANG */
 #ifdef BCMPCIE
 	int   d3ackcnt_timeout;		/* counter d3ack timeout to send HANG */
 #endif /* BCMPCIE */
 	bool hang_report;		/* enable hang report by default */
 	uint16 hang_reason;		/* reason codes for HANG event */
 #if defined(DHD_HANG_SEND_UP_TEST)
 	uint req_hang_type;
 #endif /* DHD_HANG_SEND_UP_TEST */
 #ifdef DHD_DETECT_CONSECUTIVE_MFG_HANG
 	uint hang_count;
 #endif /* DHD_DETECT_CONSECUTIVE_MFG_HANG */
 #ifdef WLTDLS
 	bool tdls_enable;
 #endif
 	struct reorder_info *reorder_bufs[WLHOST_REORDERDATA_MAXFLOWS];
 	#define WLC_IOCTL_MAXBUF_FWCAP  3072u
 	uint8 dngl_capext_buf[WLC_IOCTL_MAXBUF_FWCAP];
 	char  fw_capabilities[WLC_IOCTL_MAXBUF_FWCAP];
 	#define DHD_IOCTL_MAXBUF_DHDCAP 1024u
 	char  dhd_capabilities[DHD_IOCTL_MAXBUF_DHDCAP];
 	#define MAXSKBPEND 1024
 	void *skbbuf[MAXSKBPEND];
 	uint32 store_idx;
 	uint32 sent_idx;
 #ifdef DHDTCPACK_SUPPRESS
 	uint8 tcpack_sup_mode;		/* TCPACK suppress mode */
 	void *tcpack_sup_module;	/* TCPACK suppress module */
 	uint32 tcpack_sup_ratio;
 	uint32 tcpack_sup_delay;
 #endif /* DHDTCPACK_SUPPRESS */
 #if defined(ARP_OFFLOAD_SUPPORT)
 	uint32 arp_version;
 	bool hmac_updated;
 #endif
 #if defined(BCMSUP_4WAY_HANDSHAKE)
 	bool fw_4way_handshake;		/* Whether firmware will to do the 4way handshake. */
 #endif
 #ifdef BCMINTERNAL
 	bool loopback; /* 1- enable loopback of tx packets, 0 - disable */
 #endif /* BCMINTERNAL */
 #ifdef DEBUG_DPC_THREAD_WATCHDOG
 	bool dhd_bug_on;
 #endif /* DEBUG_DPC_THREAD_WATCHDOG */
 #ifdef CUSTOM_SET_CPUCORE
 	struct task_struct * current_dpc;
 	struct task_struct * current_rxf;
 	int chan_isvht80;
 #endif /* CUSTOM_SET_CPUCORE */
 	void    *sta_pool;          /* pre-allocated pool of sta objects */
 	void    *staid_allocator;   /* allocator of sta indexes */
 #ifdef PCIE_FULL_DONGLE
 	bool	flow_rings_inited;	/* set this flag after initializing flow rings */
 #endif /* PCIE_FULL_DONGLE */
 	void    *flowid_allocator;  /* unique flowid allocator */
 	void    *htput_flowid_allocator;  /* unique htput flowid allocator */
 	uint16	htput_client_flow_rings;  /* current number of htput client flowrings */
 	uint16	htput_flow_ring_start;	  /* start index of htput flow rings */
 	void	*flow_ring_table;   /* flow ring table, include prot and bus info */
 	void	*if_flow_lkup;      /* per interface flowid lkup hash table */
 	void    *flowid_lock;       /* per os lock for flowid info protection */
 	void    *flowring_list_lock;       /* per os lock for flowring list protection */
 	uint8	max_multi_client_flow_rings;
 	osl_atomic_t multi_client_flow_rings;
 	uint32  num_h2d_rings;		/* Max h2d rings including static and dynamic rings */
 	uint32  max_tx_flowid;		/* used to validate flowid */
 	cumm_ctr_t cumm_ctr;        /* cumm queue length placeholder  */
 	cumm_ctr_t l2cumm_ctr;      /* level 2 cumm queue length placeholder */
 	uint32 d2h_sync_mode;       /* D2H DMA completion sync mode */
 	uint8  flow_prio_map[NUMPRIO];
 	uint8	flow_prio_map_type;
 	char enable_log[MAX_EVENT];
 	bool dma_d2h_ring_upd_support;
 	bool dma_h2d_ring_upd_support;
 	bool dma_ring_upd_overwrite;	/* host overwrites support setting */

 	bool idma_enable;
 	uint idma_inited;

 	bool ifrm_enable;			/* implicit frm enable */
 	uint ifrm_inited;			/* implicit frm init */

 	bool dar_enable;		/* use DAR registers */
 	uint dar_inited;

 	bool fast_delete_ring_support;		/* fast delete ring supported */

 #ifdef DHD_WMF
 	bool wmf_ucast_igmp;
 #ifdef DHD_IGMP_UCQUERY
 	bool wmf_ucast_igmp_query;
 #endif
 #ifdef DHD_UCAST_UPNP
 	bool wmf_ucast_upnp;
 #endif
 #endif /* DHD_WMF */
 #if defined(BCM_ROUTER_DHD)
 	dhd_trf_mgmt_dwm_tbl_t dhd_tm_dwm_tbl;
 #endif /* BCM_ROUTER_DHD */
 #ifdef DHD_L2_FILTER
 	unsigned long l2_filter_cnt;	/* for L2_FILTER ARP table timeout */
 #endif /* DHD_L2_FILTER */
 #ifdef DHD_SSSR_DUMP
 	bool sssr_inited;
 	bool force_sssr_init;
 	bool sssr_dump_collected;	/* Flag to indicate sssr dump is collected */
 	sssr_reg_info_cmn_t *sssr_reg_info;
 	uint8 *sssr_mempool;
 #ifdef DHD_SSSR_DUMP_BEFORE_SR
 	uint *sssr_d11_before[MAX_NUM_D11_CORES_WITH_SCAN];
 	uint *sssr_dig_buf_before;
 #endif /* DHD_SSSR_DUMP_BEFORE_SR */
 	uint *sssr_d11_after[MAX_NUM_D11_CORES_WITH_SCAN];
 	bool sssr_d11_outofreset[MAX_NUM_D11_CORES_WITH_SCAN];
 	uint *sssr_dig_buf_after;
 	uint32 sssr_dump_mode;
 	bool collect_sssr;		/* Flag to indicate SSSR dump is required */
 	bool fis_triggered;
 	bool collect_fis;		/* Enable FIS for special cases */
 	bool dongle_fis_enab;		/* does dongle support FIS dump */
 #endif /* DHD_SSSR_DUMP */
 #ifdef DHD_SDTC_ETB_DUMP
 	etb_addr_info_t etb_addr_info;
 	uint8 *sdtc_etb_mempool;
 	uint sdtc_etb_dump_len;
 	bool sdtc_etb_inited;
 	bool collect_sdtc;		/* Flag to indicate SDTC dump is required */
 	bool etb_dap_flush_supported;
 #endif /* DHD_SDTC_ETB_DUMP */
 	uint8 *soc_ram;
 	uint32 soc_ram_length;
 	uint32 memdump_type;
 #ifdef DHD_COREDUMP
 	uint8 *coredump_mem;
 	uint32 coredump_len;
 	uint32 uc_status;		/* PCIE Uncorrectable Error Status */
 	uint8 ewp_init_state;
 	char memdump_str[DHD_MEMDUMP_LONGSTR_LEN];
 #endif /* DHD_COREDUMP */
 #ifdef COEX_CPU
 	uint8 *coex_dump;
 	uint32 coex_dump_length;
 #endif /* COEX_CPU */
 #ifdef DHD_RND_DEBUG
 	uint8 *rnd_buf;
 	uint32 rnd_len;
 #endif /* DHD_RND_DEBUG */
 #ifdef DHD_FW_COREDUMP
 	uint32 memdump_enabled;
 #ifdef DHD_DEBUG_UART
 	bool memdump_success;
 #endif	/* DHD_DEBUG_UART */
 #endif /* DHD_FW_COREDUMP */
 #ifdef PCIE_FULL_DONGLE
 #ifdef WLTDLS
 	tdls_peer_tbl_t peer_tbl;
 #endif /* WLTDLS */
 #if defined(__linux__)
 	uint8 tx_in_progress;
 #endif /* __linux__ */
 #endif /* PCIE_FULL_DONGLE */
 #ifdef CACHE_FW_IMAGES
 	char	*cached_fw;
 	int	cached_fw_length;
 	char	*cached_nvram;
 	int	cached_nvram_length;
 	char	*cached_clm;
 	int	cached_clm_length;
 	char	*cached_txcap;
 	int	cached_txcap_length;
 #endif
 #ifdef KEEP_JP_REGREV
 /* Needed by customer's request */
 	char vars_ccode[WLC_CNTRY_BUF_SZ];
 	uint vars_regrev;
 #endif /* KEEP_JP_REGREV */
 #ifdef WLTDLS
 	uint32 tdls_mode;
 #endif
 #ifdef GSCAN_SUPPORT
 	bool lazy_roam_enable;
 #endif
 #if defined(APF)
 	bool apf_set;
 #endif /* APF */
 	void *macdbg_info;
 #ifdef DHD_WET
 	void *wet_info;
 #endif
 	bool	h2d_phase_supported;
 	bool	force_dongletrap_on_bad_h2d_phase;
 	uint32	dongle_trap_data;
 	fw_download_status_t	fw_download_status;
 	trap_t	last_trap_info; /* trap info from the last trap */
 	uint8 rand_mac_oui[DOT11_OUI_LEN];
 #ifdef DHD_LOSSLESS_ROAMING
 	uint8 dequeue_prec_map;
 	uint8 prio_8021x;
 #endif
 #ifdef WL_NATOE
 	struct dhd_nfct_info *nfct;
 	spinlock_t nfct_lock;
 #endif /* WL_NATOE */
 	/* timesync link */
 	struct dhd_ts *ts;
 	bool	d2h_hostrdy_supported;
 #ifdef DHD_PCIE_NATIVE_RUNTIMEPM
 	atomic_t block_bus;
 #endif /* DHD_PCIE_NATIVE_RUNTIMEPM */
 #if defined(DBG_PKT_MON) || defined(DHD_PKT_LOGGING)
 	bool d11_tx_status;
 #endif /* DBG_PKT_MON || DHD_PKT_LOGGING */
 	uint16 ndo_version;	/* ND offload version supported */
 #ifdef NDO_CONFIG_SUPPORT
 	bool ndo_enable;		/* ND offload feature enable */
 	bool ndo_host_ip_overflow;	/* # of host ip addr exceed FW capacity */
 	uint32 ndo_max_host_ip;		/* # of host ip addr supported by FW */
 #endif /* NDO_CONFIG_SUPPORT */
 #if defined(DHD_LOG_DUMP)
 #if defined(DHD_EFI)
 	uint8 log_capture_enable;
 #endif /* DHD_EFI */
 	/* buffer to hold 'dhd dump' data before dumping to file */
 	uint8 *concise_dbg_buf;
 #ifdef EWP_DACS
 	/* buffer for fw init logs */
 	uint8 *ewphw_initlog_buf;
 	uint32 ewphw_initlog_len;
 	/* buffer for fw init reg dump */
 	uint8 *ewphw_regdump_buf;
 	uint32 ewphw_regdump_len;
 	/* buffer for fw init module dump */
 	uint8 * ewphw_moddump_buf;
 	uint32 ewphw_moddump_len;
 	/* total size of buffer alloc'd for ewp hw logs */
 	uint32 ewphw_buf_totlen;
 	/* flag set when EWP_DACS enabled after FW handshake */
 	bool ewp_dacs_fw_enable;
 #endif /* EWP_DACS */
 	bool ewp_etb_enabled;
 #ifdef EWP_ECNTRS_LOGGING
 	void *ecntr_dbg_ring;
 #endif
 #ifdef EWP_RTT_LOGGING
 	void *rtt_dbg_ring;
 #endif
 #ifdef EWP_BCM_TRACE
 	void *bcm_trace_dbg_ring;
 #endif
 #ifdef EWP_EVENTTS_LOG
 	void *eventts_dbg_ring;
 	uint8 *eventts_buf;
 #endif /* EWP_EVENTTS_LOG */
 #ifdef EWP_CX_TIMELINE
 	void *cx_timeline_dbg_ring;
 	uint8 *cx_timeline_dbg_ring_buf;
 #endif /* EWP_CX_TIMELINE */
 #ifdef DNGL_EVENT_SUPPORT
 	uint8 health_chk_event_data[HEALTH_CHK_BUF_SIZE];
 #endif
 	void *logdump_cookie;
 #endif /* DHD_LOG_DUMP */
 	uint32 dhd_console_ms; /** interval for polling the dongle for console (log) messages */
 	bool ext_trap_data_supported;
 	uint32 *extended_trap_data;
 #ifdef DUMP_IOCTL_IOV_LIST
 	/* dump iovar list */
 	dll_t dump_iovlist_head;
 	uint8 dump_iovlist_len;
 #endif /* DUMP_IOCTL_IOV_LIST */
 #ifdef REPORT_FATAL_TIMEOUTS
 	timeout_info_t *timeout_info;
 	uint16 esync_id; /* used to track escans */
 	osl_atomic_t set_ssid_rcvd; /* to track if WLC_E_SET_SSID is received during join IOVAR */
 	/* to track if WLC_E_SET_SSID is received during join IOVAR with error */
 	osl_atomic_t set_ssid_err_rcvd;
 	osl_atomic_t psk_sup_rcvd; /* to track if WLC_E_PSK_SUP is received during join IOVAR */
 	bool secure_join; /* field to note that the join is secure or not */
 #endif /* REPORT_FATAL_TIMEOUTS */
 #ifdef CUSTOM_SET_ANTNPM
 	uint32 mimo_ant_set;
 #endif /* CUSTOM_SET_ANTNPM */
 #ifdef CUSTOM_SET_OCLOFF
 	bool ocl_off;
 #endif /* CUSTOM_SET_OCLOFF */
 #ifdef DHD_DEBUG
 	/* memwaste feature */
 	dll_t mw_list_head; /* memwaste list head */
 	uint32 mw_id; /* memwaste list unique id */
 #endif /* DHD_DEBUG */
 #ifdef WLTDLS
 	spinlock_t tdls_lock;
 #endif /* WLTDLS */
 	uint pcie_txs_metadata_enable;
 #ifdef BTLOG
 	bool bt_logging;
 	bool submit_count_WAR;	/* submission count WAR */
 	bool bt_logging_enabled;
 #endif	/* BTLOG */
 	uint wbtext_policy;	/* wbtext policy of dongle */
 	bool wbtext_support;	/* for product policy only */
 #ifdef PCIE_OOB
 	bool	d2h_no_oob_dw;
 #endif /* PCIE_OOB */
 #ifdef PCIE_INB_DW
 	bool	d2h_inband_dw;
 	enum dhd_bus_ds_state	ds_state;
 #endif /* PCIE_INB_DW */
 #ifdef SNAPSHOT_UPLOAD
 	bool snapshot_upload;
 #endif /* SNAPSHOT_UPLOAD */
 	tput_test_t tput_data;
 	uint64 tput_start_ts;
 	uint64 tput_stop_ts;
 	uint dhd_watchdog_ms_backup;
 	bool logtrace_pkt_sendup;
 #ifdef GDB_PROXY
 	/* True if firmware runs under gdb control (this may cause timeouts at any point) */
 	bool gdb_proxy_active;
 	/* True if deadman_to shall be forced to 0 */
 	bool gdb_proxy_nodeadman;
 	/* Counter incremented at each firmware stop/go transition. LSB (GDB_PROXY_STOP_MASK)
 	 * is set when firmware is stopped, clear when running
 	 */
 	uint32 gdb_proxy_stop_count;
 #endif /* GDB_PROXY */
 	int debug_dump_subcmd;
 	uint64 debug_dump_time_sec;
 	bool hscb_enable;


 	uint64 logset_prsrv_mask;
 #ifdef DHD_PKT_LOGGING
 	struct dhd_pktlog *pktlog;
 	char debug_dump_time_pktlog_str[DEBUG_DUMP_TIME_BUF_LEN];
 	bool pktlog_debug;
 #endif /* DHD_PKT_LOGGING */
 #ifdef EWP_EDL
 	bool dongle_edl_support;
 	dhd_dma_buf_t edl_ring_mem;
 	bool host_edl_mem_inited;
 #endif /* EWP_EDL */
 #if defined(__linux__)
 	struct mutex ndev_op_sync;
 #endif /* defined(__linux__) */
 	bool debug_buf_dest_support;
 	uint32 debug_buf_dest_stat[DEBUG_BUF_DEST_MAX];
 #ifdef WL_CFGVENDOR_SEND_HANG_EVENT
 	char *hang_info;
 	int hang_info_cnt;
 	char debug_dump_time_hang_str[DEBUG_DUMP_TIME_BUF_LEN];
 #endif /* WL_CFGVENDOR_SEND_HANG_EVENT */
 	char debug_dump_time_str[DEBUG_DUMP_TIME_BUF_LEN];
 	void *event_log_filter;
 	uint tput_test_done;
 #if defined(__linux__)
 	wait_queue_head_t tx_tput_test_wait;
 	wait_queue_head_t tx_completion_wait;


 #endif /* defined(__linux__) */
 #ifdef DHD_ERPOM
 	bool enable_erpom;
 	pom_func_handler_t pom_wlan_handler;
 	int (*pom_func_register)(pom_func_handler_t *func);
 	int (*pom_func_deregister)(pom_func_handler_t *func);
 	int (*pom_toggle_reg_on)(uchar func_id, uchar reason);
 #endif /* DHD_ERPOM */
 #if defined(DHD_H2D_LOG_TIME_SYNC)
 #define DHD_H2D_LOG_TIME_STAMP_MATCH	(10000) /* 10 Seconds */
 	/*
 	 * Interval for updating the dongle console message time stamp with the Host (DHD)
 	 * time stamp
 	 */
 	uint32 dhd_rte_time_sync_ms;
 #endif /* DHD_H2D_LOG_TIME_SYNC */
 	uint32 batch_tx_pkts_cmpl;
 	uint32 batch_tx_num_pkts;
 #ifdef DHD_EFI
 	bool insert_random_mac;
 	/* threshold # of pkts Tx'd/Rx'd after which efi dhd
 	 * will switch intr poll period to 100us
 	*/
 	uint64 npkts_thresh;
 	/* the period of time in which if no pkt is Tx'd/Rx'd
 	 * efi dhd will restore intr poll period to default value
 	*/
 	uint64 pkt_intvl_thresh_us;
 	/* time stamp of last Tx'd pkt */
 	uint64 tx_last_pkt_ts;
 	/* time stamp of last Rx'd pkt */
 	uint64 rx_last_pkt_ts;
 	/* used to temporarily store the current intr poll period
 	 * during efi dhd iovar execution, so as to restore it back
 	 * once iovar completes
 	*/
 	uint32 cur_intr_poll_period;
 	/* the intr poll period set by user through dhd iovar */
 	uint32 iovar_intr_poll_period;
 	bool pcie_readshared_done;
 #endif /* DHD_EFI */
 #ifdef DHD_DUMP_MNGR
 	struct _dhd_dump_file_manage *dump_file_manage;
 #endif /* DHD_DUMP_MNGR */
 #ifdef BCMINTERNAL

 #ifdef DHD_FWTRACE
 	fwtrace_info_t *fwtrace_info; /* f/w trace information */
 #endif	/* DHD_FWTRACE */

 #endif	/* BCMINTERNAL */
 	bool event_log_max_sets_queried;
 	uint32 event_log_max_sets;
 #ifdef DHD_STATUS_LOGGING
 	void *statlog;
 #endif /* DHD_STATUS_LOGGING */
 #ifdef DHD_MAP_PKTID_LOGGING
 	bool enable_pktid_log_dump;
 #endif /* DHD_MAP_PKTID_LOGGING */
 #ifdef DHD_HP2P
 	/* whether enabled from host by user iovar */
 	bool hp2p_enable;
 	bool hp2p_infra_enable;
 	/* whether fw supports it */
 	bool hp2p_capable;
 	bool hp2p_mf_enable;
 	bool hp2p_ts_capable;
 	bool dur_scale_capable;
 	uint16 pkt_thresh;
 	uint16 time_thresh;
 	uint16 pkt_expiry;
 	uint8 scale_factor;
 	uint8 tx_dur_scale;
 	uint8 rx_dur_scale;
 	/* Flag to allow more hp2p ring creation */
 	bool hp2p_ring_more;
 	hp2p_info_t hp2p_info[MAX_HP2P_FLOWS];
 #endif /* D2H_HP2P */
 #ifdef DHD_DB0TS
 	bool db0ts_capable;
 #endif /* DHD_DB0TS */
 	bool extdtxs_in_txcpl;
 	bool hostrdy_after_init;
 	uint16 dhd_induce_error;
 	uint16 dhd_induce_bh_error;
 	int wlc_ver_major;
 	int wlc_ver_minor;


 #ifdef SUPPORT_SET_TID
 	uint8 tid_mode;
 	uint32 target_uid;
 	uint8 target_tid;
 #endif /* SUPPORT_SET_TID */
 #ifdef DHD_PKTDUMP_ROAM
 	void *pktcnts;
 #endif /* DHD_PKTDUMP_ROAM */
 	bool fw_preinit;
 	dhd_db7_info_t db7_trap;
 	union {
 		wl_roam_stats_v1_t v1;
 	} roam_evt;
 	bool ring_attached;
 #ifdef DHD_PCIE_RUNTIMEPM
 #ifdef RPM_FAST_TRIGGER
 	bool rpm_fast_trigger;
 	bool rpm_fast_candidate;
 #endif /* RPM_FAST_TRIGGER */
 #endif /* DHD_PCIE_RUNTIMEPM */
 	bool arpoe_enable;
 	bool arpol_configured;
 #ifdef DHD_TX_PROFILE
 	bool tx_profile_enab;
 	uint8 num_profiles;
 	dhd_tx_profile_protocol_t *protocol_filters;
 #endif /* defined(DHD_TX_PROFILE) */
 	uint8 dhd_udr;
 	bool check_trap_rot;
 #ifdef DHD_MEM_STATS
 	void *mem_stats_lock;
 	uint64 txpath_mem;
 	uint64 rxpath_mem;
 #endif /* DHD_MEM_STATS */
 #ifdef DHD_LB_RXP
 	atomic_t lb_rxp_flow_ctrl;
 	uint32 lb_rxp_stop_thr;
 	uint32 lb_rxp_strt_thr;
 	uint32 lb_rxp_emerge_enqueue_err;
 #endif /* DHD_LB_RXP */
 #ifdef DHD_LB_STATS
 	uint64 lb_rxp_stop_thr_hitcnt;
 	uint64 lb_rxp_strt_thr_hitcnt;
 	uint64 lb_rxp_napi_sched_cnt;
 	uint64 lb_rxp_napi_complete_cnt;
 	uint64 rx_dma_stall_hc_ignore_cnt;
 #endif /* DHD_LB_STATS */
 #ifdef TX_CSO
 	bool dongle_txcso_enabled;
 	bool host_txcso_enabled;
 #endif /* TX_CSO */
 #ifdef RX_CSO
 	bool rxcso_enabled;
 #endif /* RX_CSO */
 	bool dongle_txpost_ext_enabled;
 	/* if dongle support PTM */
 	bool dongle_support_ptm;
 	/* if FW supports host insertion of SFH LLC */
 	bool host_sfhllc_supported;

 	/* Indicates if the firmware supports the mesh */
 	bool mesh_enabled;

 #if defined(DHD_MESH)
 	void *mesh_rt_lock;	/* Mesh routing table spin lock */
 #endif /* defined(DHD_MESH) */

 #ifdef DBG_PKT_MON
 	bool aml_enable;	/* aml(assoc mgmt frame logger) enable flags */
 #endif /* DBG_PKT_MON */
 #ifdef WL_CFGVENDOR_SEND_ALERT_EVENT
 	uint32 alert_reason;		/* reason codes for alert event */
 #endif /* WL_CFGVENDOR_SEND_ALERT_EVENT */

 	/* Do not toggle wlan regulator during init */
 	bool reg_on_through_init;
 	bool fw_mode_changed;
 	bool do_chip_bighammer;
 	uint chip_bighammer_count;
 	bool rx_cpl_lat_capable; /* FW supports latency posting in Rx cpl ring */
 	rx_cpl_lat_info_t rxcpl_lat_info; /* Rx Cpl latency information */
 	tx_cpl_info_t txcpl_info; /* TX completion timestamp info */
 	bool	fw_lpm_support;
 #ifdef SUPPORT_OTA_UPDATE
 	ota_update_info_t ota_update_info;
 #endif /* SUPPORT_OTA_UPDATE */
 	bool stop_in_progress;
 #ifdef DHD_GRO_ENABLE_HOST_CTRL
 	bool permitted_gro;
 #endif /* DHD_GRO_ENABLE_HOST_CTRL */

 	/* Pointer to Platform Layer */
 	void *plat_info;
 	uint32 plat_info_size;
 	bool htput_support;
 	bool htput_force_sta;
 	uint16 htput_sta_flowrings;	/* Number for htput flowring for STA */
 	uint16 htput_client_flowrings;	/* Number for htput flowring for clients */
 	uint16 htput_total_flowrings;	/* Total number for htput flowrings (Sta and client) */
 #ifdef FLOW_RING_PREALLOC
 	uint16 max_prealloc_flowrings;
 	uint16 max_prealloc_regular_flowrings;
 #endif /* FLOW_RING_PREALLOC */
 	bool igmpo_enable; /* fw supports igmp offload */
 #ifdef DHD_SPMI
 	uint dhd_spmi_mode;
 #endif /* DHD_SPMI */
 	bool mdring_capable; /* FW supports metadata ring cpl ring */
 	uint8 *mdring_info;  /* Saved metadta ring work items */
 	uint32 md_item_count; /* # of saved metadata work items */
 #if defined(DEVICE_TX_STUCK_DETECT) && defined(ASSOC_CHECK_SR)
 	/* is infra associated or not before suspend ? */
 	bool assoc_at_suspend;
 #endif /* DEVICE_TX_STUCK_DETECT && ASSOC_CHECK_SR */
 	uint32 p2p_disc_busy_cnt;
 	bool skip_memdump_map_read;
 	bool if_opened;
 #ifdef DHD_SDTC_ETB_DUMP
 	bool etb_dump_inited;
 #endif /* DHD_SDTC_ETB_DUMP */
 #if defined(DHD_TIMESYNC)
 	void *ts_lock;
 #endif /* DHD_TIMESYNC */
 #ifdef DHD_SSSR_DUMP_BEFORE_SR
 	uint *sssr_saqm_buf_before;
 #endif /* DHD_SSSR_DUMP_BEFORE_SR */
 	uint *sssr_saqm_buf_after;
 	bool skip_logdmp;
 #ifdef DHD_TREAT_D3ACKTO_AS_LINKDWN
 	bool no_pcie_access_during_dump;
 #endif /* DHD_TREAT_D3ACKTO_AS_LINKDWN */
 #ifdef DHD_SSSR_DUMP
 	uint *sssr_srcb_buf_after;
 	uint *sssr_cmn_buf_after;
 #endif /* DHD_SSSR_DUMP */
 #ifdef DHD_VALIDATE_PKT_ADDRESS
 	uint badaddr_pkt_cnt;
 #endif /* DHD_VALIDATE_PKT_ADDRESS */
 	uint32 armpc;
 	uint32 arm_assert_phy_addr;
 	bool usr_trig_dmp;
 } dhd_pub_t;

 #if defined(__linux__)
 int dhd_wifi_platform_set_power(dhd_pub_t *pub, bool on);
 #else
 static INLINE int dhd_wifi_platform_set_power(dhd_pub_t *pub, bool on)  { return 0; }
 #endif /* __linux__ */

 #define MAX_WAKE_REASON_STATS	32u
 typedef struct {
 	uint rxwake;
 	uint rcwake;
 #ifdef DHD_WAKE_RX_STATUS
 	uint rx_bcast;
 	uint rx_arp;
 	uint rx_mcast;
 	uint rx_multi_ipv6;
 	uint rx_icmp;
 	uint rx_icmpv6;
 	uint rx_icmpv6_ra;
 	uint rx_icmpv6_na;
 	uint rx_icmpv6_ns;
 	uint rx_multi_ipv4;
 	uint rx_multi_other;
 	uint rx_ucast;
 #endif /* DHD_WAKE_RX_STATUS */
 #ifdef DHD_WAKE_EVENT_STATUS
 #ifdef CUSTOM_WAKE_REASON_STATS
 	int rc_event[MAX_WAKE_REASON_STATS];
 	int rc_event_idx;
 #else
 	uint rc_event[WLC_E_LAST];
 #endif /* CUSTOM_WAKE_REASON_STATS */
 #endif /* DHD_WAKE_EVENT_STATUS */
 } wake_counts_t;

 #if defined(PCIE_FULL_DONGLE)
 /*
  * WARNING: dhd_wlfc.h also defines a dhd_pkttag_t
  * making wlfc incompatible with PCIE_FULL DONGLE
  */

 /* Packet Tag for PCIE Full Dongle DHD */
 typedef struct dhd_pkttag_fd {
 	uint16    flowid;   /* Flowring Id */
 	uint16    ifid;
 #ifdef DHD_SBN
 	uint8	  pkt_udr;
 	uint8	  pad;
 #endif /* DHD_SBN */
 #if defined(BCM_ROUTER_DHD) && defined(BCM_GMAC3)
 	uint16    dataoff;  /* start of packet */
 #endif /* BCM_ROUTER_DHD && BCM_GMAC3 */
 #ifndef DHD_PCIE_PKTID
 	uint16    dma_len;  /* pkt len for DMA_MAP/UNMAP */
 	dmaaddr_t pa;       /* physical address */
 	void      *dmah;    /* dma mapper handle */
 	void      *secdma; /* secure dma sec_cma_info handle */
 #endif /* !DHD_PCIE_PKTID */
 #if defined(TX_STATUS_LATENCY_STATS) || defined(DHD_PKTTS)
 	uint64	   q_time_us; /* time when tx pkt queued to flowring */
 #endif /* TX_STATUS_LATENCY_STATS || DHD_PKTTS */
 } dhd_pkttag_fd_t;

 /* Packet Tag for DHD PCIE Full Dongle */
 #define DHD_PKTTAG_FD(pkt)          ((dhd_pkttag_fd_t *)(PKTTAG(pkt)))

 #define DHD_PKT_GET_FLOWID(pkt)     ((DHD_PKTTAG_FD(pkt))->flowid)
 #define DHD_PKT_SET_FLOWID(pkt, pkt_flowid) \
 	DHD_PKTTAG_FD(pkt)->flowid = (uint16)(pkt_flowid)

 #define DHD_PKT_GET_DATAOFF(pkt)    ((DHD_PKTTAG_FD(pkt))->dataoff)
 #define DHD_PKT_SET_DATAOFF(pkt, pkt_dataoff) \
 	DHD_PKTTAG_FD(pkt)->dataoff = (uint16)(pkt_dataoff)

 #define DHD_PKT_GET_DMA_LEN(pkt)    ((DHD_PKTTAG_FD(pkt))->dma_len)
 #define DHD_PKT_SET_DMA_LEN(pkt, pkt_dma_len) \
 	DHD_PKTTAG_FD(pkt)->dma_len = (uint16)(pkt_dma_len)

 #define DHD_PKT_GET_PA(pkt)         ((DHD_PKTTAG_FD(pkt))->pa)
 #define DHD_PKT_SET_PA(pkt, pkt_pa) \
 	DHD_PKTTAG_FD(pkt)->pa = (dmaaddr_t)(pkt_pa)

 #define DHD_PKT_GET_DMAH(pkt)       ((DHD_PKTTAG_FD(pkt))->dmah)
 #define DHD_PKT_SET_DMAH(pkt, pkt_dmah) \
 	DHD_PKTTAG_FD(pkt)->dmah = (void *)(pkt_dmah)

 #define DHD_PKT_GET_SECDMA(pkt)    ((DHD_PKTTAG_FD(pkt))->secdma)
 #define DHD_PKT_SET_SECDMA(pkt, pkt_secdma) \
 	DHD_PKTTAG_FD(pkt)->secdma = (void *)(pkt_secdma)

 #if defined(TX_STATUS_LATENCY_STATS) || defined(DHD_PKTTS)
 #define DHD_PKT_GET_QTIME(pkt)    ((DHD_PKTTAG_FD(pkt))->q_time_us)
 #define DHD_PKT_SET_QTIME(pkt, pkt_q_time_us) \
 	DHD_PKTTAG_FD(pkt)->q_time_us = (uint64)(pkt_q_time_us)
 #endif /* TX_STATUS_LATENCY_STATS || DHD_PKTTS */
 #endif /* PCIE_FULL_DONGLE */

 #if defined(BCMWDF)
 typedef struct {
 	dhd_pub_t *dhd_pub;
 } dhd_workitem_context_t;

 WDF_DECLARE_CONTEXT_TYPE_WITH_NAME(dhd_workitem_context_t, dhd_get_dhd_workitem_context)
 #endif /* (BCMWDF)  */

 #if defined(__linux__)
 #if defined(CONFIG_PM_SLEEP)

 #define DHD_PM_RESUME_WAIT_INIT(a) DECLARE_WAIT_QUEUE_HEAD(a);
 #define _DHD_PM_RESUME_WAIT(a, b) do {\
 			int retry = 0; \
 			SMP_RD_BARRIER_DEPENDS(); \
 			while (dhd_mmc_suspend && retry++ != b) { \
 				SMP_RD_BARRIER_DEPENDS(); \
 				wait_event_interruptible_timeout(a, !dhd_mmc_suspend, 1); \
 			} \
 		}	while (0)
 #define DHD_PM_RESUME_WAIT(a)		_DHD_PM_RESUME_WAIT(a, 200)
 #define DHD_PM_RESUME_WAIT_FOREVER(a)	_DHD_PM_RESUME_WAIT(a, ~0)
 #define DHD_PM_RESUME_RETURN_ERROR(a)   do { \
 			if (dhd_mmc_suspend) { \
 				printf("%s[%d]: mmc is still in suspend state!!!\n", \
 					__FUNCTION__, __LINE__); \
 				return a; \
 			} \
 		} while (0)
 #define DHD_PM_RESUME_RETURN		do { if (dhd_mmc_suspend) return; } while (0)

 #define DHD_SPINWAIT_SLEEP_INIT(a) DECLARE_WAIT_QUEUE_HEAD(a);
 #define SPINWAIT_SLEEP(a, exp, us) do { \
 		uint countdown = (us) + 9999; \
 		while ((exp) && (countdown >= 10000)) { \
 			wait_event_interruptible_timeout(a, FALSE, 1); \
 			countdown -= 10000; \
 		} \
 	} while (0)

 #else

 #define DHD_PM_RESUME_WAIT_INIT(a)
 #define DHD_PM_RESUME_WAIT(a)
 #define DHD_PM_RESUME_WAIT_FOREVER(a)
 #define DHD_PM_RESUME_RETURN_ERROR(a)
 #define DHD_PM_RESUME_RETURN

 #define DHD_SPINWAIT_SLEEP_INIT(a)
 #define SPINWAIT_SLEEP(a, exp, us)  do { \
 		uint countdown = (us) + 9; \
 		while ((exp) && (countdown >= 10)) { \
 			OSL_DELAY(10);  \
 			countdown -= 10;  \
 		} \
 	} while (0)

 #endif /* CONFIG_PM_SLEEP */
 #else
 	#define DHD_SPINWAIT_SLEEP_INIT(a)
 	#define SPINWAIT_SLEEP(a, exp, us)  do { \
 		uint countdown = (us) + 9; \
 		while ((exp) && (countdown >= 10)) { \
 			OSL_DELAY(10);  \
 			countdown -= 10;  \
 		} \
 	} while (0)
 #endif /* defined(__linux__) */

 #define DHD_IF_VIF	0x01	/* Virtual IF (Hidden from user) */

 #ifdef PNO_SUPPORT
 int dhd_pno_clean(dhd_pub_t *dhd);
 #endif /* PNO_SUPPORT */

 /*
  *  Wake locks are an Android power management concept. They are used by applications and services
  *  to request CPU resources.
  */

 #if defined(OEM_ANDROID)
 extern int dhd_os_wake_lock(dhd_pub_t *pub);
 extern int dhd_os_wake_unlock(dhd_pub_t *pub);
 extern int dhd_os_wake_lock_waive(dhd_pub_t *pub);
 extern int dhd_os_wake_lock_restore(dhd_pub_t *pub);
 extern void dhd_event_wake_lock(dhd_pub_t *pub);
 extern void dhd_event_wake_unlock(dhd_pub_t *pub);
 extern void dhd_pm_wake_lock_timeout(dhd_pub_t *pub, int val);
 extern void dhd_pm_wake_unlock(dhd_pub_t *pub);
 extern void dhd_txfl_wake_lock_timeout(dhd_pub_t *pub, int val);
 extern void dhd_txfl_wake_unlock(dhd_pub_t *pub);
 extern void dhd_nan_wake_lock_timeout(dhd_pub_t *pub, int val);
 extern void dhd_nan_wake_unlock(dhd_pub_t *pub);
 extern int dhd_os_wake_lock_timeout(dhd_pub_t *pub);
 extern int dhd_os_wake_lock_rx_timeout_enable(dhd_pub_t *pub, int val);
 extern int dhd_os_wake_lock_ctrl_timeout_enable(dhd_pub_t *pub, int val);
 extern int dhd_os_wake_lock_ctrl_timeout_cancel(dhd_pub_t *pub);
 extern int dhd_os_wd_wake_lock(dhd_pub_t *pub);
 extern int dhd_os_wd_wake_unlock(dhd_pub_t *pub);
 extern void dhd_os_wake_lock_init(struct dhd_info *dhd);
 extern void dhd_os_wake_lock_destroy(struct dhd_info *dhd);
 #ifdef DHD_USE_SCAN_WAKELOCK
 extern void dhd_os_scan_wake_lock_timeout(dhd_pub_t *pub, int val);
 extern void dhd_os_scan_wake_unlock(dhd_pub_t *pub);
 #endif /* BCMPCIE_SCAN_WAKELOCK */

 inline static void MUTEX_LOCK_SOFTAP_SET_INIT(dhd_pub_t * dhdp)
 {
 #if defined(OEM_ANDROID)
 	mutex_init(&dhdp->wl_softap_lock);
 #endif /* OEM_ANDROID */
 }

 inline static void MUTEX_LOCK_SOFTAP_SET(dhd_pub_t * dhdp)
 {
 #if defined(OEM_ANDROID)
 	mutex_lock(&dhdp->wl_softap_lock);
 #endif /* OEM_ANDROID */
 }

 inline static void MUTEX_UNLOCK_SOFTAP_SET(dhd_pub_t * dhdp)
 {
 #if defined(OEM_ANDROID)
 	mutex_unlock(&dhdp->wl_softap_lock);
 #endif /* OEM_ANDROID */
 }

 #ifdef DHD_DEBUG_WAKE_LOCK
 #define DHD_OS_WAKE_LOCK(pub) \
 	do { \
 		printf("call wake_lock: %s %d\n", \
 			__FUNCTION__, __LINE__); \
 		dhd_os_wake_lock(pub); \
 	} while (0)
 #define DHD_OS_WAKE_UNLOCK(pub) \
 	do { \
 		printf("call wake_unlock: %s %d\n", \
 			__FUNCTION__, __LINE__); \
 		dhd_os_wake_unlock(pub); \
 	} while (0)
 #define DHD_EVENT_WAKE_LOCK(pub) \
 	do { \
 		printf("call event wake_lock: %s %d\n", \
 			__FUNCTION__, __LINE__); \
 		dhd_event_wake_lock(pub); \
 	} while (0)
 #define DHD_EVENT_WAKE_UNLOCK(pub) \
 	do { \
 		printf("call event wake_unlock: %s %d\n", \
 			__FUNCTION__, __LINE__); \
 		dhd_event_wake_unlock(pub); \
 	} while (0)
 #define DHD_PM_WAKE_LOCK_TIMEOUT(pub, val) \
 	do { \
 		printf("call pm_wake_timeout enable: %s %d\n", \
 			__FUNCTION__, __LINE__); \
 		dhd_pm_wake_lock_timeout(pub, val); \
 	} while (0)
 #define DHD_PM_WAKE_UNLOCK(pub) \
 	do { \
 		printf("call pm_wake unlock: %s %d\n", \
 			__FUNCTION__, __LINE__); \
 		dhd_pm_wake_unlock(pub); \
 	} while (0)
 #define DHD_TXFL_WAKE_LOCK_TIMEOUT(pub, val) \
 	do { \
 		printf("call txfl_wake_timeout enable: %s %d\n", \
 			__FUNCTION__, __LINE__); \
 		dhd_txfl_wake_lock_timeout(pub, val); \
 	} while (0)
 #define DHD_TXFL_WAKE_UNLOCK(pub) \
 	do { \
 		printf("call txfl_wake unlock: %s %d\n", \
 			__FUNCTION__, __LINE__); \
 		dhd_txfl_wake_unlock(pub); \
 	} while (0)
 #define DHD_NAN_WAKE_LOCK_TIMEOUT(pub, val) \
 	do { \
 		printf("call nan_wake_timeout enable: %s %d\n", \
 			__FUNCTION__, __LINE__); \
 		dhd_nan_wake_lock_timeout(pub, val); \
 	} while (0)
 #define DHD_NAN_WAKE_UNLOCK(pub) \
 	do { \
 		printf("call nan_wake unlock: %s %d\n", \
 			__FUNCTION__, __LINE__); \
 		dhd_nan_wake_unlock(pub); \
 	} while (0)
 #define DHD_OS_WAKE_LOCK_TIMEOUT(pub) \
 	do { \
 		printf("call wake_lock_timeout: %s %d\n", \
 			__FUNCTION__, __LINE__); \
 		dhd_os_wake_lock_timeout(pub); \
 	} while (0)
 #define DHD_OS_WAKE_LOCK_RX_TIMEOUT_ENABLE(pub, val) \
 	do { \
 		printf("call dhd_wake_lock_rx_timeout_enable[%d]: %s %d\n", \
 			val, __FUNCTION__, __LINE__); \
 		dhd_os_wake_lock_rx_timeout_enable(pub, val); \
 	} while (0)
 #define DHD_OS_WAKE_LOCK_CTRL_TIMEOUT_ENABLE(pub, val) \
 	do { \
 		printf("call dhd_wake_lock_ctrl_timeout_enable[%d]: %s %d\n", \
 			val, __FUNCTION__, __LINE__); \
 		dhd_os_wake_lock_ctrl_timeout_enable(pub, val); \
 	} while (0)
 #define DHD_OS_WAKE_LOCK_CTRL_TIMEOUT_CANCEL(pub) \
 	do { \
 		printf("call dhd_wake_lock_ctrl_timeout_cancel: %s %d\n", \
 			__FUNCTION__, __LINE__); \
 		dhd_os_wake_lock_ctrl_timeout_cancel(pub); \
 	} while (0)
 #define DHD_OS_WAKE_LOCK_WAIVE(pub) \
 	do { \
 		printf("call dhd_wake_lock_waive: %s %d\n", \
 			__FUNCTION__, __LINE__); \
 		dhd_os_wake_lock_waive(pub); \
 	} while (0)
 #define DHD_OS_WAKE_LOCK_RESTORE(pub) \
 	do { \
 		printf("call dhd_wake_lock_restore: %s %d\n", \
 			__FUNCTION__, __LINE__); \
 		dhd_os_wake_lock_restore(pub); \
 	} while (0)
 #define DHD_OS_WAKE_LOCK_INIT(dhd) \
 	do { \
 		printf("call dhd_wake_lock_init: %s %d\n", \
 			__FUNCTION__, __LINE__); \
 		dhd_os_wake_lock_init(dhd); \
 	} while (0)
 #define DHD_OS_WAKE_LOCK_DESTROY(dhd) \
 	do { \
 		printf("call dhd_wake_dhd_lock_destroy: %s %d\n", \
 			__FUNCTION__, __LINE__); \
 		dhd_os_wake_lock_destroy(dhd); \
 	} while (0)
 #else
 #define DHD_OS_WAKE_LOCK(pub)			dhd_os_wake_lock(pub)
 #define DHD_OS_WAKE_UNLOCK(pub)		dhd_os_wake_unlock(pub)
 #define DHD_EVENT_WAKE_LOCK(pub)			dhd_event_wake_lock(pub)
 #define DHD_EVENT_WAKE_UNLOCK(pub)		dhd_event_wake_unlock(pub)
 #define DHD_PM_WAKE_LOCK_TIMEOUT(pub, val)  dhd_pm_wake_lock_timeout(pub, val)
 #define DHD_PM_WAKE_UNLOCK(pub) 			dhd_pm_wake_unlock(pub)
 #define DHD_TXFL_WAKE_LOCK_TIMEOUT(pub, val)	dhd_txfl_wake_lock_timeout(pub, val)
 #define DHD_TXFL_WAKE_UNLOCK(pub) 			dhd_txfl_wake_unlock(pub)
 #define DHD_NAN_WAKE_LOCK_TIMEOUT(pub, val)	dhd_nan_wake_lock_timeout(pub, val)
 #define DHD_NAN_WAKE_UNLOCK(pub)		dhd_nan_wake_unlock(pub)
 #define DHD_OS_WAKE_LOCK_TIMEOUT(pub)		dhd_os_wake_lock_timeout(pub)
 #define DHD_OS_WAKE_LOCK_RX_TIMEOUT_ENABLE(pub, val) \
 	dhd_os_wake_lock_rx_timeout_enable(pub, val)
 #define DHD_OS_WAKE_LOCK_CTRL_TIMEOUT_ENABLE(pub, val) \
 	dhd_os_wake_lock_ctrl_timeout_enable(pub, val)
 #define DHD_OS_WAKE_LOCK_CTRL_TIMEOUT_CANCEL(pub) \
 	dhd_os_wake_lock_ctrl_timeout_cancel(pub)
 #define DHD_OS_WAKE_LOCK_WAIVE(pub)			dhd_os_wake_lock_waive(pub)
 #define DHD_OS_WAKE_LOCK_RESTORE(pub)		dhd_os_wake_lock_restore(pub)
 #define DHD_OS_WAKE_LOCK_INIT(dhd)		dhd_os_wake_lock_init(dhd);
 #define DHD_OS_WAKE_LOCK_DESTROY(dhd)		dhd_os_wake_lock_destroy(dhd);
 #endif /* DHD_DEBUG_WAKE_LOCK */

 #define DHD_OS_WD_WAKE_LOCK(pub)		dhd_os_wd_wake_lock(pub)
 #define DHD_OS_WD_WAKE_UNLOCK(pub)		dhd_os_wd_wake_unlock(pub)

 #ifdef DHD_USE_SCAN_WAKELOCK
 #ifdef DHD_DEBUG_SCAN_WAKELOCK
 #define DHD_OS_SCAN_WAKE_LOCK_TIMEOUT(pub, val) \
 	do { \
 		printf("call wake_lock_scan: %s %d\n", \
 			__FUNCTION__, __LINE__); \
 		dhd_os_scan_wake_lock_timeout(pub, val); \
 	} while (0)
 #define DHD_OS_SCAN_WAKE_UNLOCK(pub) \
 	do { \
 		printf("call wake_unlock_scan: %s %d\n", \
 			__FUNCTION__, __LINE__); \
 		dhd_os_scan_wake_unlock(pub); \
 	} while (0)
 #else
 #define DHD_OS_SCAN_WAKE_LOCK_TIMEOUT(pub, val)		dhd_os_scan_wake_lock_timeout(pub, val)
 #define DHD_OS_SCAN_WAKE_UNLOCK(pub)			dhd_os_scan_wake_unlock(pub)
 #endif /* DHD_DEBUG_SCAN_WAKELOCK */
 #else
 #define DHD_OS_SCAN_WAKE_LOCK_TIMEOUT(pub, val)
 #define DHD_OS_SCAN_WAKE_UNLOCK(pub)
 #endif /* DHD_USE_SCAN_WAKELOCK */

 #endif /* defined(OEM_ANDROID) */

 #if !defined(OEM_ANDROID)

 /* Wake lock are used in Android only (until the Linux community accepts it) */
 #define DHD_OS_WAKE_LOCK(pub)
 #define DHD_OS_WAKE_UNLOCK(pub)
 #define DHD_EVENT_WAKE_LOCK(pub)
 #define DHD_EVENT_WAKE_UNLOCK(pub)
 #define DHD_PM_WAKE_LOCK_TIMEOUT(pub, val)
 #define DHD_PM_WAKE_UNLOCK(pub)
 #define DHD_TXFL_WAKE_LOCK_TIMEOUT(pub, val)
 #define DHD_TXFL_WAKE_UNLOCK(pub)
 #define DHD_NAN_WAKE_LOCK_TIMEOUT(pub, val)
 #define DHD_NAN_WAKE_UNLOCK(pub)
 #define DHD_OS_WD_WAKE_LOCK(pub)
 #define DHD_OS_WD_WAKE_UNLOCK(pub)
 #define DHD_OS_WAKE_LOCK_TIMEOUT(pub)
 #define DHD_OS_WAKE_LOCK_RX_TIMEOUT_ENABLE(pub, val)	UNUSED_PARAMETER(val)
 #define DHD_OS_WAKE_LOCK_CTRL_TIMEOUT_ENABLE(pub, val)	UNUSED_PARAMETER(val)
 #define DHD_OS_WAKE_LOCK_CTRL_TIMEOUT_CANCEL(pub, val)
 #define DHD_OS_WAKE_LOCK_WAIVE(pub)
 #define DHD_OS_WAKE_LOCK_RESTORE(pub)
 #define DHD_OS_SCAN_WAKE_LOCK_TIMEOUT(pub, val)
 #define DHD_OS_SCAN_WAKE_UNLOCK(pub)
 #define DHD_OS_WAKE_LOCK_INIT(dhd)
 #define DHD_OS_WAKE_LOCK_DESTROY(dhd)

 #endif /* defined(OEM_ANDROID) */

 #ifdef BCMPCIE_OOB_HOST_WAKE
 #define OOB_WAKE_LOCK_TIMEOUT 500
 extern void dhd_os_oob_irq_wake_lock_timeout(dhd_pub_t *pub, int val);
 extern void dhd_os_oob_irq_wake_unlock(dhd_pub_t *pub);

 #define DHD_OS_OOB_IRQ_WAKE_LOCK_TIMEOUT(pub, val)	dhd_os_oob_irq_wake_lock_timeout(pub, val)
 #define DHD_OS_OOB_IRQ_WAKE_UNLOCK(pub)			dhd_os_oob_irq_wake_unlock(pub)
 #endif /* BCMPCIE_OOB_HOST_WAKE */

 /* The DHD_PACKET_TIMEOUT_MS & MAX_TX_TIMEOUT are used for wake_lock timeout
  * to prevent the system from entering suspend during TX/RX frame processing.
  * It can be adjusted depending on the host platform.
  */
 #define DHD_MONITOR_TIMEOUT_MS	1000
 #define DHD_PACKET_TIMEOUT_MS	100
 #define DHD_HANDSHAKE_TIMEOUT_MS	1000
 #define DHD_EVENT_TIMEOUT_MS	1500
 #define SCAN_WAKE_LOCK_TIMEOUT	10000
 #define MAX_TX_TIMEOUT			100

 /* Enum for IOCTL received status */
 typedef enum dhd_ioctl_received_status
 {
 	IOCTL_WAIT = 0,
 	IOCTL_RETURN_ON_SUCCESS,
 	IOCTL_RETURN_ON_TRAP,
 	IOCTL_RETURN_ON_BUS_STOP,
 	IOCTL_RETURN_ON_ERROR
 } dhd_ioctl_received_status_t;

 /* interface operations (register, remove) should be atomic, use this lock to prevent race
  * condition among wifi on/off and interface operation functions
  */
 #if defined(__linux__)
 void dhd_net_if_lock(struct net_device *dev);
 void dhd_net_if_unlock(struct net_device *dev);
 #endif /* __linux__ */

 #if defined(__linux__)
 #if defined(MULTIPLE_SUPPLICANT)

 #if defined(OEM_ANDROID) && defined(BCMSDIO)
 extern struct mutex _dhd_sdio_mutex_lock_;
 #endif

 #endif /* MULTIPLE_SUPPLICANT */
 #endif /* defined(__linux__) */

 typedef enum dhd_attach_states
 {
 	DHD_ATTACH_STATE_INIT = 0x0,
 	DHD_ATTACH_STATE_NET_ALLOC = 0x1,
 	DHD_ATTACH_STATE_DHD_ALLOC = 0x2,
 	DHD_ATTACH_STATE_ADD_IF = 0x4,
 	DHD_ATTACH_STATE_PROT_ATTACH = 0x8,
 	DHD_ATTACH_STATE_WL_ATTACH = 0x10,
 	DHD_ATTACH_STATE_THREADS_CREATED = 0x20,
 	DHD_ATTACH_STATE_WAKELOCKS_INIT = 0x40,
 	DHD_ATTACH_STATE_CFG80211 = 0x80,
 	DHD_ATTACH_STATE_EARLYSUSPEND_DONE = 0x100,
 	DHD_ATTACH_TIMESYNC_ATTACH_DONE = 0x200,
 	DHD_ATTACH_LOGTRACE_INIT = 0x400,
 	DHD_ATTACH_STATE_LB_ATTACH_DONE = 0x800,
 	DHD_ATTACH_STATE_DONE = 0x1000
 } dhd_attach_states_t;

 /* Value -1 means we are unsuccessful in creating the kthread. */
 #define DHD_PID_KT_INVALID		-1
 /* Value -2 means we are unsuccessful in both creating the kthread and tasklet */
 #define DHD_PID_KT_TL_INVALID		-2

 /* default reporting period */
 #define ECOUNTERS_DEFAULT_PERIOD	0

 /* default number of reports. '0' indicates forever */
 #define ECOUNTERS_NUM_REPORTS		0

 typedef struct ecounters_cfg {
 	uint16 type;
 	uint16 if_slice_idx;
 	uint16 stats_rep;
 } ecounters_cfg_t;

 typedef struct event_ecounters_cfg {
 	uint16 event_id;
 	uint16 type;
 	uint16 if_slice_idx;
 	uint16 stats_rep;
 } event_ecounters_cfg_t;

 typedef struct ecountersv2_xtlv_list_elt {
 	/* Not quite the exact bcm_xtlv_t type as data could be pointing to other pieces in
 	 * memory at the time of parsing arguments.
 	 */
 	uint16 id;
 	uint16 len;
 	uint8 *data;
 	struct ecountersv2_xtlv_list_elt *next;
 } ecountersv2_xtlv_list_elt_t;

 typedef struct ecountersv2_processed_xtlv_list_elt {
 	uint8 *data;
 	struct ecountersv2_processed_xtlv_list_elt *next;
 } ecountersv2_processed_xtlv_list_elt;

 /*
  * Exported from dhd OS modules (dhd_linux/dhd_ndis)
  */

 /* Indication from bus module regarding presence/insertion of dongle.
  * Return dhd_pub_t pointer, used as handle to OS module in later calls.
  * Returned structure should have bus and prot pointers filled in.
  * bus_hdrlen specifies required headroom for bus module header.
  */
 extern dhd_pub_t *dhd_attach(osl_t *osh, struct dhd_bus *bus, uint bus_hdrlen);
 extern int dhd_attach_net(dhd_pub_t *dhdp, bool need_rtnl_lock);
 #if defined(WLP2P) && defined(WL_CFG80211)
 /* To allow attach/detach calls corresponding to p2p0 interface  */
 extern int dhd_attach_p2p(dhd_pub_t *);
 extern int dhd_detach_p2p(dhd_pub_t *);
 #endif /* WLP2P && WL_CFG80211 */
 extern int dhd_register_if(dhd_pub_t *dhdp, int idx, bool need_rtnl_lock);

 /* Indication from bus module regarding removal/absence of dongle */
 extern void dhd_detach(dhd_pub_t *dhdp);
 extern void dhd_free(dhd_pub_t *dhdp);
 extern void dhd_clear(dhd_pub_t *dhdp);

 /* Indication from bus module to change flow-control state */
 extern void dhd_txflowcontrol(dhd_pub_t *dhdp, int ifidx, bool on);

 /* Store the status of a connection attempt for later retrieval by an iovar */
 extern void dhd_store_conn_status(uint32 event, uint32 status, uint32 reason);
 extern bool dhd_prec_enq(dhd_pub_t *dhdp, struct pktq *q, void *pkt, int prec);
 extern void dhd_rx_frame(dhd_pub_t *dhdp, int ifidx, void *rxp, int numpkt, uint8 chan);

 /* Return pointer to interface name */
 extern char *dhd_ifname(dhd_pub_t *dhdp, int idx);

 #ifdef DHD_UCODE_DOWNLOAD
 /* Returns the ucode path */
 extern char *dhd_get_ucode_path(dhd_pub_t *dhdp);
 #endif /* DHD_UCODE_DOWNLOAD */

 /* Request scheduling of the bus dpc */
 extern void dhd_sched_dpc(dhd_pub_t *dhdp);

 /* Notify tx completion */
 extern void dhd_txcomplete(dhd_pub_t *dhdp, void *txp, bool success);
 #ifdef DHD_4WAYM4_FAIL_DISCONNECT
 extern void dhd_eap_txcomplete(dhd_pub_t *dhdp, void *txp, bool success, int ifidx);
 extern void dhd_cleanup_m4_state_work(dhd_pub_t *dhdp, int ifidx);
 #endif /* DHD_4WAYM4_FAIL_DISCONNECT */

 #ifdef DHD_PCIE_NATIVE_RUNTIMEPM
 extern void dhd_bus_wakeup_work(dhd_pub_t *dhdp);
 #endif /* DHD_PCIE_NATIVE_RUNTIMEPM */

 #define WIFI_FEATURE_INFRA              0x0001      /* Basic infrastructure mode        */
 #define WIFI_FEATURE_INFRA_5G           0x0002      /* Support for 5 GHz Band           */
 #define WIFI_FEATURE_HOTSPOT            0x0004      /* Support for GAS/ANQP             */
 #define WIFI_FEATURE_P2P                0x0008      /* Wifi-Direct                      */
 #define WIFI_FEATURE_SOFT_AP            0x0010      /* Soft AP                          */
 #define WIFI_FEATURE_GSCAN              0x0020      /* Google-Scan APIs                 */
 #define WIFI_FEATURE_NAN                0x0040      /* Neighbor Awareness Networking    */
 #define WIFI_FEATURE_D2D_RTT            0x0080      /* Device-to-device RTT             */
 #define WIFI_FEATURE_D2AP_RTT           0x0100      /* Device-to-AP RTT                 */
 #define WIFI_FEATURE_BATCH_SCAN         0x0200      /* Batched Scan (legacy)            */
 #define WIFI_FEATURE_PNO                0x0400      /* Preferred network offload        */
 #define WIFI_FEATURE_ADDITIONAL_STA     0x0800      /* Support for two STAs             */
 #define WIFI_FEATURE_TDLS               0x1000      /* Tunnel directed link setup       */
 #define WIFI_FEATURE_TDLS_OFFCHANNEL    0x2000      /* Support for TDLS off channel     */
 #define WIFI_FEATURE_EPR                0x4000      /* Enhanced power reporting         */
 #define WIFI_FEATURE_AP_STA             0x8000      /* Support for AP STA Concurrency   */
 #define WIFI_FEATURE_LINKSTAT           0x10000     /* Support for Linkstats            */
 #define WIFI_FEATURE_LOGGER             0x20000     /* WiFi Logger			*/
 #define WIFI_FEATURE_HAL_EPNO           0x40000	    /* WiFi PNO enhanced                */
 #define WIFI_FEATURE_RSSI_MONITOR       0x80000     /* RSSI Monitor                     */
 #define WIFI_FEATURE_MKEEP_ALIVE        0x100000    /* WiFi mkeep_alive			*/
 #define WIFI_FEATURE_CONFIG_NDO         0x200000    /* ND offload configure             */
 #define WIFI_FEATURE_TX_TRANSMIT_POWER  0x400000    /* Capture Tx transmit power levels */
 #define WIFI_FEATURE_CONTROL_ROAMING    0x800000    /* Enable/Disable firmware roaming  */
 #define WIFI_FEATURE_FILTER_IE          0x1000000   /* Probe req ie filter              */
 #define WIFI_FEATURE_SCAN_RAND          0x2000000   /* MAC & Prb SN randomization       */
 #define WIFI_FEATURE_SET_TX_POWER_LIMIT 0x4000000   /* Support Tx Power Limit setting   */
 #define WIFI_FEATURE_USE_BODY_HEAD_SAR  0x8000000   /* Support Body/Head Proximity SAR  */
 #define WIFI_FEATURE_SET_LATENCY_MODE   0x40000000  /* Support Latency mode setting     */
 #define WIFI_FEATURE_P2P_RAND_MAC       0x80000000  /* Support P2P MAC randomization    */
 #define WIFI_FEATURE_INVALID            0xFFFFFFFF  /* Invalid Feature                  */

 #define MAX_FEATURE_SET_CONCURRRENT_GROUPS  3

 #if defined(__linux__)
 extern int dhd_dev_get_feature_set(struct net_device *dev);
 extern int dhd_dev_get_feature_set_matrix(struct net_device *dev, int num);
 extern int dhd_dev_cfg_rand_mac_oui(struct net_device *dev, uint8 *oui);
 extern int dhd_update_rand_mac_addr(dhd_pub_t *dhd);
 #ifdef CUSTOM_FORCE_NODFS_FLAG
 extern int dhd_dev_set_nodfs(struct net_device *dev, uint nodfs);
 #endif /* CUSTOM_FORCE_NODFS_FLAG */
 #ifdef NDO_CONFIG_SUPPORT
 #ifndef NDO_MAX_HOST_IP_ENTRIES
 #define NDO_MAX_HOST_IP_ENTRIES	10
 #endif /* NDO_MAX_HOST_IP_ENTRIES */

 extern int dhd_dev_ndo_cfg(struct net_device *dev, u8 enable);
 extern int dhd_dev_ndo_update_inet6addr(struct net_device * dev);
 #endif /* NDO_CONFIG_SUPPORT */
 #endif /* __linux__ */

 extern int dhd_set_rand_mac_oui(dhd_pub_t *dhd);

 #ifdef GSCAN_SUPPORT
 extern int dhd_dev_set_lazy_roam_cfg(struct net_device *dev,
              wlc_roam_exp_params_t *roam_param);
 extern int dhd_dev_lazy_roam_enable(struct net_device *dev, uint32 enable);
 extern int dhd_dev_set_lazy_roam_bssid_pref(struct net_device *dev,
        wl_bssid_pref_cfg_t *bssid_pref, uint32 flush);
 #endif /* GSCAN_SUPPORT */
 #if defined(GSCAN_SUPPORT) || defined(ROAMEXP_SUPPORT)
 extern int dhd_dev_set_blacklist_bssid(struct net_device *dev, maclist_t *blacklist,
     uint32 len, uint32 flush);
 extern int dhd_dev_set_whitelist_ssid(struct net_device *dev, wl_ssid_whitelist_t *whitelist,
     uint32 len, uint32 flush);
 #endif /* GSCAN_SUPPORT || ROAMEXP_SUPPORT */

 /* OS independent layer functions */
 extern void dhd_os_dhdiovar_lock(dhd_pub_t *pub);
 extern void dhd_os_dhdiovar_unlock(dhd_pub_t *pub);
 void dhd_os_logdump_lock(dhd_pub_t *pub);
 void dhd_os_logdump_unlock(dhd_pub_t *pub);
 extern int dhd_os_proto_block(dhd_pub_t * pub);
 extern int dhd_os_proto_unblock(dhd_pub_t * pub);
 extern int dhd_os_ioctl_resp_wait(dhd_pub_t * pub, uint * condition);
 extern int dhd_os_ioctl_resp_wake(dhd_pub_t * pub);
 extern unsigned int dhd_os_get_ioctl_resp_timeout(void);
 extern void dhd_os_set_ioctl_resp_timeout(unsigned int timeout_msec);
 extern void dhd_os_ioctl_resp_lock(dhd_pub_t * pub);
 extern void dhd_os_ioctl_resp_unlock(dhd_pub_t * pub);
 extern int dhd_os_read_file(void *file, char *buf, uint32 size);
 extern int dhd_os_seek_file(void *file, int64 offset);
 #ifdef PCIE_FULL_DONGLE
 extern void dhd_wakeup_ioctl_event(dhd_pub_t *pub, dhd_ioctl_received_status_t reason);
 #else
 static INLINE void dhd_wakeup_ioctl_event(dhd_pub_t *pub, dhd_ioctl_received_status_t reason)
 { printf("%s is NOT implemented for SDIO", __FUNCTION__); return; }
 #endif
 #ifdef SHOW_LOGTRACE
 /* Bound and delay are fine tuned after several experiments and these
  * are the best case values to handle bombarding of console logs.
  */
 #define DHD_EVENT_LOGTRACE_BOUND 10u
 #define DHD_EVENT_LOGTRACE_RESCHEDULE_DELAY_MS 10u
 #endif /* SHOW_LOGTRACE */
 int dhd_os_write_file_posn(void *fp, unsigned long *posn,
 		void *buf, unsigned long buflen);
 int dhd_msix_message_set(dhd_pub_t *dhdp, uint table_entry,
     uint message_number, bool unmask);

 #if defined(DHD_EFI)
 void dhd_os_set_intr_poll_period(struct dhd_bus *bus, unsigned int period_us);
 unsigned int dhd_os_get_intr_poll_period(void);
 int dhd_intr_poll(struct dhd_bus *bus, char *arg, int len, int set);
 #define INTR_POLL_PERIOD_CRITICAL 100 /* 100us -- in us */
 #define INTR_POLL_NPKTS_THRESH 1
 #define INTR_POLL_PKT_INTERVAL_THRESH 2000000 /* 2000ms -- in us */
 #if defined(DHD_INTR_POLL_PERIOD_DYNAMIC)
 void dhd_intr_poll_pkt_thresholds(dhd_pub_t *dhd);
 #endif /* DHD_INTR_POLL_PERIOD_DYNAMIC */
 #endif /* DHD_EFI && DHD_INTR_POLL_PERIOD_DYNAMIC */

 #ifdef DHD_DEBUG
 void dhd_convert_memdump_type_to_str(uint32 type, char *buf, size_t buf_len, int substr_type);
 #endif /* DHD_DEBUG */

 #ifdef DHD_COREDUMP
 void dhd_convert_hang_reason_to_str(uint32 reason, char *buf, size_t buf_len);
 #endif /* DHD_COREDUMP */

 extern void
 dhd_pcie_dump_core_regs(dhd_pub_t * pub, uint32 index, uint32 first_addr, uint32 last_addr);
 extern void wl_dhdpcie_dump_regs(void * context);

 #if defined(NDIS)
 #define dhd_os_open_image(a) wl_os_open_image(a)
 #define dhd_os_close_image(a) wl_os_close_image(a)
 #define dhd_os_get_image_block(a, b, c) wl_os_get_image_block(a, b, c)
 #define dhd_os_get_image_size(a) wl_os_get_image_size(a)
 extern void dhd_os_wakeind(dhd_pub_t * pub, uint32 *val);
 extern void dhd_bus_check_died(void *bus);
 extern void pci_save_state(osl_t *osh, uint32 *buffer);
 extern void pci_restore_state(osl_t *osh, uint32 *buffer);
 #endif /* #if defined(NDIS) */

 extern int dhd_os_get_image_block(char * buf, int len, void * image);
 extern int dhd_os_get_image_size(void * image);
 #if defined(BT_OVER_SDIO)
 extern int dhd_os_gets_image(dhd_pub_t *pub, char *str, int len, void *image);
 extern void dhdsdio_bus_usr_cnt_inc(dhd_pub_t *pub);
 extern void dhdsdio_bus_usr_cnt_dec(dhd_pub_t *pub);
 #endif /* (BT_OVER_SDIO) */
 extern void *dhd_os_open_image1(dhd_pub_t *pub, char *filename); /* rev1 function signature */
 extern void dhd_os_close_image1(dhd_pub_t *pub, void *image);
 extern void dhd_os_wd_timer(void *bus, uint wdtick);
 #ifdef DHD_PCIE_RUNTIMEPM
 extern void dhd_os_runtimepm_timer(void *bus, uint tick);
 #endif /* DHD_PCIE_RUNTIMEPM */
 extern void dhd_os_sdlock(dhd_pub_t * pub);
 extern void dhd_os_sdunlock(dhd_pub_t * pub);
 extern void dhd_os_sdlock_txq(dhd_pub_t * pub);
 extern void dhd_os_sdunlock_txq(dhd_pub_t * pub);
 extern void dhd_os_sdlock_rxq(dhd_pub_t * pub);
 extern void dhd_os_sdunlock_rxq(dhd_pub_t * pub);
 extern void dhd_os_sdlock_sndup_rxq(dhd_pub_t * pub);
 extern void dhd_os_tracelog(const char *format, ...);
 #ifdef DHDTCPACK_SUPPRESS
 extern unsigned long dhd_os_tcpacklock(dhd_pub_t *pub);
 extern void dhd_os_tcpackunlock(dhd_pub_t *pub, unsigned long flags);
 #endif /* DHDTCPACK_SUPPRESS */

 extern int dhd_customer_oob_irq_map(void *adapter, unsigned long *irq_flags_ptr);
 extern int dhd_customer_gpio_wlan_ctrl(void *adapter, int onoff);
 extern int dhd_custom_get_mac_address(void *adapter, unsigned char *buf);
 #if defined(CUSTOM_COUNTRY_CODE)
 extern void get_customized_country_code(void *adapter, char *country_iso_code,
 	wl_country_t *cspec, u32 flags);
 #else
 extern void get_customized_country_code(void *adapter, char *country_iso_code, wl_country_t *cspec);
 #endif /* CUSTOM_COUNTRY_CODE */
 extern void dhd_os_sdunlock_sndup_rxq(dhd_pub_t * pub);
 extern void dhd_os_sdlock_eventq(dhd_pub_t * pub);
 extern void dhd_os_sdunlock_eventq(dhd_pub_t * pub);
 extern bool dhd_os_check_hang(dhd_pub_t *dhdp, int ifidx, int ret);
 #ifdef OEM_ANDROID
 extern int dhd_os_send_hang_message(dhd_pub_t *dhdp);
 #endif /* OEM_ANDROID */
 extern void dhd_set_version_info(dhd_pub_t *pub, char *fw);
 extern bool dhd_os_check_if_up(dhd_pub_t *pub);
 extern int dhd_os_check_wakelock(dhd_pub_t *pub);
 extern int dhd_os_check_wakelock_all(dhd_pub_t *pub);
 extern int dhd_get_instance(dhd_pub_t *pub);
 #ifdef CUSTOM_SET_CPUCORE
 extern void dhd_set_cpucore(dhd_pub_t *dhd, int set);
 #endif /* CUSTOM_SET_CPUCORE */

 #ifdef DHD_DETECT_CONSECUTIVE_MFG_HANG
 #define MAX_CONSECUTIVE_MFG_HANG_COUNT 2
 #endif /* DHD_DETECT_CONSECUTIVE_MFG_HANG */


 #if defined(DHD_FW_COREDUMP)
 #if defined(linux) || defined(LINUX)
 extern bool dhd_memdump_is_scheduled(dhd_pub_t *dhdp);
 #else
 static INLINE bool dhd_memdump_is_scheduled(dhd_pub_t *dhdp) { return FALSE; }
 #endif /* linux || LINUX */
 void dhd_schedule_memdump(dhd_pub_t *dhdp, uint8 *buf, uint32 size);
 #endif /* DHD_FW_COREDUMP */

 #if defined(__linux__)
 int dhd_os_get_img_fwreq(const struct firmware **fw, const char *file_path);
 void dhd_os_close_img_fwreq(const struct firmware *fw);
 #if defined(DHD_SSSR_DUMP)
 void dhd_write_sssr_dump(dhd_pub_t *dhdp, uint32 dump_mode);
 #endif /* DHD_SSSR_DUMP */
 #ifdef DNGL_AXI_ERROR_LOGGING
 void dhd_schedule_axi_error_dump(dhd_pub_t *dhdp, void *type);
 #endif /* DNGL_AXI_ERROR_LOGGING */
 #ifdef BCMPCIE
 void dhd_schedule_cto_recovery(dhd_pub_t *dhdp);
 #endif /* BCMPCIE */
 #else
 #if defined(DHD_SSSR_DUMP)
 static INLINE void dhd_write_sssr_dump(dhd_pub_t *dhd, uint32 dump_mode) { return; }
 #endif /* DHD_SSSR_DUMP */
 #ifdef DNGL_AXI_ERROR_LOGGING
 static INLINE void dhd_schedule_axi_error_dump(dhd_pub_t *dhdp, void *type) { return; }
 #endif /* DNGL_AXI_ERROR_LOGGING */
 /* For non-linux map dhd_schedule_cto_recovery to dhdpcie_cto_recovery_handler */
 #ifdef BCMPCIE
 #define dhd_schedule_cto_recovery(dhdp) dhdpcie_cto_recovery_handler(dhdp)
 #endif /* BCMPCIE */
 #endif /* __linux__ */

 bool dhd_os_check_image_exists(dhd_pub_t *pub, char *filename);

 #ifdef EWP_EDL
 #define EDL_SCHEDULE_DELAY 500 /* 500ms */
 #if defined(__linux__)
 void dhd_schedule_edl_work(dhd_pub_t *dhdp, uint delay_ms);
 #else
 static INLINE void dhd_schedule_edl_work(dhd_pub_t *dhd, uint delay_ms) { return; }
 #endif /* __linux__ */
 #endif /* EWP_EDL */

 #ifdef SUPPORT_AP_POWERSAVE
 extern int dhd_set_ap_powersave(dhd_pub_t *dhdp, int ifidx, int enable);
 #endif /* SUPPORT_AP_POWERSAVE */

 #ifdef PKT_FILTER_SUPPORT
 #define DHD_UNICAST_FILTER_NUM		0
 #define DHD_BROADCAST_FILTER_NUM	1
 #define DHD_MULTICAST4_FILTER_NUM	2
 #define DHD_MULTICAST6_FILTER_NUM	3
 #define DHD_MDNS_FILTER_NUM		4
 #define DHD_ARP_FILTER_NUM		5
 #define DHD_BROADCAST_ARP_FILTER_NUM	6
 #define DHD_IP4BCAST_DROP_FILTER_NUM	7
 #define DHD_LLC_STP_DROP_FILTER_NUM	8
 #define DHD_LLC_XID_DROP_FILTER_NUM	9
 #define DHD_UDPNETBIOS_DROP_FILTER_NUM	10
 #define DISCARD_IPV4_MCAST	"102 1 6 IP4_H:16 0xf0 0xe0"
 #define DISCARD_IPV6_MCAST	"103 1 6 IP6_H:24 0xff 0xff"
 #define DISCARD_IPV4_BCAST	"107 1 6 IP4_H:16 0xffffffff 0xffffffff"
 #define DISCARD_LLC_STP		"108 1 6 ETH_H:14 0xFFFFFFFFFFFF 0xAAAA0300000C"
 #define DISCARD_LLC_XID		"109 1 6 ETH_H:14 0xFFFFFF 0x0001AF"
 #define DISCARD_UDPNETBIOS	"110 1 6 UDP_H:2 0xffff 0x0089"
 extern int dhd_os_enable_packet_filter(dhd_pub_t *dhdp, int val);
 extern void dhd_enable_packet_filter(int value, dhd_pub_t *dhd);
 extern int dhd_packet_filter_add_remove(dhd_pub_t *dhdp, int add_remove, int num);
 extern int net_os_enable_packet_filter(struct net_device *dev, int val);
 extern int net_os_rxfilter_add_remove(struct net_device *dev, int val, int num);

 #define MAX_PKTFLT_BUF_SIZE		2048
 #define MAX_PKTFLT_FIXED_PATTERN_SIZE	32
 #define MAX_PKTFLT_FIXED_BUF_SIZE	\
 	(WL_PKT_FILTER_FIXED_LEN + MAX_PKTFLT_FIXED_PATTERN_SIZE * 2)
 #define MAXPKT_ARG	16
 #endif /* PKT_FILTER_SUPPORT */

 extern bool dhd_support_sta_mode(dhd_pub_t *dhd);
 extern int write_to_file(dhd_pub_t *dhd, uint8 *buf, int size);

 #ifdef RSSI_MONITOR_SUPPORT
 extern int dhd_dev_set_rssi_monitor_cfg(struct net_device *dev, int start,
              int8 max_rssi, int8 min_rssi);
 #endif /* RSSI_MONITOR_SUPPORT */

 #ifdef DHDTCPACK_SUPPRESS
 int dhd_dev_set_tcpack_sup_mode_cfg(struct net_device *dev, uint8 enable);
 #endif /* DHDTCPACK_SUPPRESS */

 #define DHD_RSSI_MONITOR_EVT_VERSION   1
 typedef struct {
 	uint8 version;
 	int8 cur_rssi;
 	struct ether_addr BSSID;
 } dhd_rssi_monitor_evt_t;

 typedef struct {
 	uint32 limit;		/* Expiration time (usec) */
 	uint32 increment;	/* Current expiration increment (usec) */
 	uint32 elapsed;		/* Current elapsed time (usec) */
 	uint32 tick;		/* O/S tick time (usec) */
 } dhd_timeout_t;

 #ifdef SHOW_LOGTRACE
 typedef struct dhd_event_log_fmt {
 	uint	num_fmts;	/* Number of formats in logstrs */
 	char	**fmts;		/* Parsed format string pointer array pointer */
 	char	*raw_fmts;	/* logstrs file payload */
 	uint32	fmts_size;	/* size of pointer array *fmts */
 	uint32	raw_fmts_size;	/* size of logstrs file paylod *raw_fmts */
 } dhd_event_log_fmt_t;

 typedef struct dhd_event_log_map {
 	char *raw_sstr;		/* raw static string payload */
 	uint32 raw_sstr_size;	/* size of raw static string payload */
 	uint32 ramstart;	/* text_start address */
 	uint32 rodata_start;	/* rodata_start address */
 	uint32 rodata_end;	/* rodata_end address */
 } dhd_event_log_map_t;

 #if defined(__linux__) || defined(DHD_EFI)
 typedef struct dhd_event_log {
 	dhd_event_log_fmt_t wlan_fmts;	/* wlan logstrs context */

 #ifdef COEX_CPU
 	dhd_event_log_fmt_t coex_fmts;	/* coex logstrs context */
 #endif /* COEX_CPU */

 	dhd_event_log_map_t ram;	/* wlan ram static string context */
 	dhd_event_log_map_t rom;	/* wlan rom static string context */

 #ifdef COEX_CPU
 	dhd_event_log_map_t coex;	/* coex static string context */
 #endif /* COEX_CPU */

 } dhd_event_log_t;
 #else /* __linux__ || DHD_EFI */
 typedef struct {
 	uint  num_fmts;
 	char **fmts;
 	char *raw_fmts;
 	char *raw_sstr;
 	uint32 fmts_size;
 	uint32 raw_fmts_size;
 	uint32 raw_sstr_size;
 	uint32 ramstart;
 	uint32 rodata_start;
 	uint32 rodata_end;
 	char *rom_raw_sstr;
 	uint32 rom_raw_sstr_size;
 	uint32 rom_ramstart;
 	uint32 rom_rodata_start;
 	uint32 rom_rodata_end;
 } dhd_event_log_t;
 #endif /* __linux__ || DHD_EFI */
 #endif /* SHOW_LOGTRACE */

 #ifdef WL_MLO
 #define MAX_MLO_LINK 3

 typedef struct dhd_mlo_peer_link {
 	struct ether_addr link_addr;
 	chanspec_t chspec;
 } dhd_mlo_peer_link_t;

 typedef struct dhd_mlo_peer_info {
 	u8 num_links;
 	struct ether_addr mld_addr;
 	dhd_mlo_peer_link_t link_info[MAX_MLO_LINK];
 } dhd_mlo_peer_info_t;
 #endif /* WL_MLO */

 #if defined(APF)
 /*
  * As per Google's current implementation, there will be only one APF filter.
  * Therefore, userspace doesn't bother about filter id and because of that
  * DHD has to manage the filter id.
  */
 #define PKT_FILTER_APF_ID		200
 #define DHD_APF_LOCK(ndev)		dhd_apf_lock(ndev)
 #define DHD_APF_UNLOCK(ndev)		dhd_apf_unlock(ndev)

 extern void dhd_apf_lock(struct net_device *dev);
 extern void dhd_apf_unlock(struct net_device *dev);
 extern int dhd_dev_apf_get_version(struct net_device *ndev, uint32 *version);
 extern int dhd_dev_apf_get_max_len(struct net_device *ndev, uint32 *max_len);
 extern int dhd_dev_apf_add_filter(struct net_device *ndev, u8* program, uint32 program_len);
 extern int dhd_dev_apf_enable_filter(struct net_device *ndev);
 extern int dhd_dev_apf_disable_filter(struct net_device *ndev);
 extern int dhd_dev_apf_delete_filter(struct net_device *ndev);
 extern int dhd_dev_apf_read_filter_data(struct net_device *ndev, u8* buf, uint32 buf_len);
 #endif /* APF */

 extern void dhd_timeout_start(dhd_timeout_t *tmo, uint usec);
 extern int dhd_timeout_expired(dhd_timeout_t *tmo);

 extern int dhd_ifname2idx(struct dhd_info *dhd, char *name);
 #if defined(__linux__)
 extern int dhd_net2idx(struct dhd_info *dhd, struct net_device *net);
 extern struct net_device * dhd_idx2net(void *pub, int ifidx);
 extern int net_os_send_hang_message(struct net_device *dev);
 extern int net_os_send_hang_message_reason(struct net_device *dev, const char *string_num);
 #endif
 extern bool dhd_wowl_cap(void *bus);
 extern int wl_host_event(dhd_pub_t *dhd_pub, int *idx, void *pktdata, uint pktlen,
 	wl_event_msg_t *, void **data_ptr,  void *);
 extern int wl_process_host_event(dhd_pub_t *dhd_pub, int *idx, void *pktdata, uint pktlen,
 	wl_event_msg_t *, void **data_ptr,  void *);
 extern void wl_event_to_host_order(wl_event_msg_t * evt);
 extern int wl_host_event_get_data(void *pktdata, uint pktlen, bcm_event_msg_u_t *evu);
 extern int dhd_wl_ioctl(dhd_pub_t *dhd_pub, int ifindex, wl_ioctl_t *ioc, void *buf, int len);
 extern int dhd_wl_ioctl_cmd(dhd_pub_t *dhd_pub, int cmd, void *arg, int len, uint8 set,
                             int ifindex);
 extern int dhd_wl_ioctl_get_intiovar(dhd_pub_t *dhd_pub, char *name, uint *pval,
 	int cmd, uint8 set, int ifidx);
 extern int dhd_wl_ioctl_set_intiovar(dhd_pub_t *dhd_pub, char *name, uint val,
 	int cmd, uint8 set, int ifidx);
 extern void dhd_common_init(osl_t *osh);

 #if defined(__linux__)
 extern int dhd_do_driver_init(struct net_device *net);
 #endif

 extern int dhd_event_ifadd(struct dhd_info *dhd, struct wl_event_data_if *ifevent,
 	char *name, uint8 *mac);
 extern int dhd_event_ifdel(struct dhd_info *dhd, struct wl_event_data_if *ifevent,
 	char *name, uint8 *mac);
 extern int dhd_event_ifchange(struct dhd_info *dhd, struct wl_event_data_if *ifevent,
        char *name, uint8 *mac);
 extern struct net_device* dhd_allocate_if(dhd_pub_t *dhdpub, int ifidx, const char *name,
 	uint8 *mac, uint8 bssidx, bool need_rtnl_lock, const char *dngl_name);
 extern int dhd_remove_if(dhd_pub_t *dhdpub, int ifidx, bool need_rtnl_lock);
 #ifdef WL_STATIC_IF
 extern s32 dhd_update_iflist_info(dhd_pub_t *dhdp, struct net_device *ndev, int ifidx,
 	uint8 *mac, uint8 bssidx, const char *dngl_name, int if_state);
 #endif /* WL_STATIC_IF */
 extern void dhd_vif_add(struct dhd_info *dhd, int ifidx, char * name);
 extern void dhd_vif_del(struct dhd_info *dhd, int ifidx);
 extern void dhd_event(struct dhd_info *dhd, char *evpkt, int evlen, int ifidx);
 extern void dhd_vif_sendup(struct dhd_info *dhd, int ifidx, uchar *cp, int len);
 #if defined(__linux__)
 void dhd_print_if_stats(dhd_pub_t *dhdp, struct bcmstrbuf *strbuf);
 void dhd_clear_if_stats(dhd_pub_t *dhdp);
 #else
 static INLINE void dhd_print_if_stats(dhd_pub_t *dhdp, struct bcmstrbuf *strbuf)
 {
 	printf("%s: NOT IMPLEMENTED\n", __FUNCTION__);
 }

 static INLINE void dhd_clear_if_stats(dhd_pub_t *dhdp) { return; }
 #endif

 #ifdef WL_NATOE
 extern int dhd_natoe_ct_event(dhd_pub_t *dhd, char *data);
 #endif /* WL_NATOE */

 /* Send packet to dongle via data channel */
 extern int dhd_sendpkt(dhd_pub_t *dhdp, int ifidx, void *pkt);

 /* send up locally generated event */
 extern void dhd_sendup_event_common(dhd_pub_t *dhdp, wl_event_msg_t *event, void *data);
 /* Send event to host */
 extern void dhd_sendup_event(dhd_pub_t *dhdp, wl_event_msg_t *event, void *data);
 #ifdef LOG_INTO_TCPDUMP
 extern void dhd_sendup_log(dhd_pub_t *dhdp, void *data, int len);
 #endif /* LOG_INTO_TCPDUMP */
 #if defined(SHOW_LOGTRACE) && defined(EWP_EDL)
 void dhd_sendup_info_buf(dhd_pub_t *dhdp, uint8 *msg);
 #endif
 #if defined(WIFI_TURNON_USE_HALINIT)
 extern int dhd_open(struct net_device *net);
 #endif /* WIFI_TURNON_USE_HALINIT */
 #if defined(LINUX) || defined(linux)
 extern int dhd_stop(struct net_device *net);
 #endif /* LINUX */
 extern int dhd_bus_devreset(dhd_pub_t *dhdp, uint8 flag);
 extern uint dhd_bus_status(dhd_pub_t *dhdp);
 extern int  dhd_bus_start(dhd_pub_t *dhdp);
 extern int dhd_bus_suspend(dhd_pub_t *dhdpub);
 extern int dhd_bus_resume(dhd_pub_t *dhdpub, int stage);
 extern int dhd_bus_membytes(dhd_pub_t *dhdp, bool set, uint32 address, uint8 *data, uint size);
 extern void dhd_print_buf(void *pbuf, int len, int bytes_per_line);
 extern bool dhd_is_associated(dhd_pub_t *dhd, uint8 ifidx, int *retval);
 #if defined(BCMSDIO) || defined(BCMPCIE)
 extern uint dhd_bus_chip_id(dhd_pub_t *dhdp);
 extern uint dhd_bus_chiprev_id(dhd_pub_t *dhdp);
 extern uint dhd_bus_chippkg_id(dhd_pub_t *dhdp);
 #endif /* defined(BCMSDIO) || defined(BCMPCIE) */
 #if defined(__linux__)
 int dhd_bus_get_fw_mode(dhd_pub_t *dhdp);
 #else
 static INLINE int dhd_bus_get_fw_mode(dhd_pub_t *dhdp) { return 0; }
 #endif /* __linux__ */

 /* linux is defined for DHD EFI builds also,
 * since its cross-compiled for EFI from linux.
 * dbgring_lock apis are meant only for linux
 * to use mutexes, other OSes will continue to
 * use osl_spin_lock
 */
 #if defined(__linux__) && !defined(DHD_EFI)
 void *dhd_os_dbgring_lock_init(osl_t *osh);
 void dhd_os_dbgring_lock_deinit(osl_t *osh, void *mtx);
 unsigned long dhd_os_dbgring_lock(void *lock);
 void dhd_os_dbgring_unlock(void *lock, unsigned long flags);
 #endif /* __linux__ && !DHD_EFI */

 #ifdef PCIE_INB_DW
 #ifdef DHD_EFI
 extern int dhd_os_ds_enter_wait(dhd_pub_t * pub, uint * condition);
 extern int dhd_os_ds_enter_wake(dhd_pub_t * pub);
 #else
 static INLINE int dhd_os_ds_enter_wait(dhd_pub_t * pub, uint * condition)
 { return 1; }
 static INLINE int dhd_os_ds_enter_wake(dhd_pub_t * pub)
 { return 0; }
 #endif /* DHD_EFI */
 #endif /* PCIE_INB_DW */

 #define FWBOOT_INTR_TIMEOUT_MS 5000u

 #if defined(__linux__) || defined(DHD_EFI)
 extern int dhd_os_busbusy_wait_negation(dhd_pub_t * pub, uint * condition);
 extern int dhd_os_busbusy_wake(dhd_pub_t * pub);
 extern void dhd_os_tx_completion_wake(dhd_pub_t *dhd);
 extern int dhd_os_busbusy_wait_condition(dhd_pub_t *pub, uint *var, uint condition);
 extern int dhd_os_d3ack_wait(dhd_pub_t * pub, uint * condition);
 extern int dhd_os_d3ack_wake(dhd_pub_t * pub);
 extern int dhd_os_dmaxfer_wait(dhd_pub_t *pub, uint *condition);
 extern int dhd_os_dmaxfer_wake(dhd_pub_t *pub);
 int dhd_os_busbusy_wait_bitmask(dhd_pub_t *pub, uint *var,
 		uint bitmask, uint condition);
 #ifdef PCIE_INB_DW
 extern int dhd_os_ds_exit_wait(dhd_pub_t * pub, uint * condition);
 extern int dhd_os_ds_exit_wake(dhd_pub_t * pub);
 #endif /* PCIE_INB_DW */
 int dhd_os_tput_test_wait(dhd_pub_t *pub, uint *condition, uint timeout_ms);
 int dhd_os_tput_test_wake(dhd_pub_t * pub);
 #else
 static INLINE int dhd_os_tput_test_wait(dhd_pub_t *pub, uint *condition,
 		uint timeout_ms)
 { return 0; }
 static INLINE int dhd_os_tput_test_wake(dhd_pub_t * pub)
 { return 0; }
 static INLINE int dhd_os_d3ack_wait(dhd_pub_t * pub, uint * condition)
 { return dhd_os_ioctl_resp_wait(pub, condition); }
 static INLINE int dhd_os_d3ack_wake(dhd_pub_t * pub)
 { return dhd_os_ioctl_resp_wake(pub); }
 #ifdef PCIE_INB_DW
 static INLINE int dhd_os_ds_exit_wait(dhd_pub_t * pub, uint * condition)
 { DHD_ERROR(("%s is Not supported for this platform", __FUNCTION__)); return 0; }
 static INLINE int dhd_os_ds_exit_wake(dhd_pub_t * pub)
 { DHD_ERROR(("%s is Not supported for this platform", __FUNCTION__)); return 0; }
 #endif /* PCIE_INB_DW */
 static INLINE int dhd_os_busbusy_wait_negation(dhd_pub_t * pub, uint * condition)
 { return 1; }
 static INLINE int dhd_os_busbusy_wake(dhd_pub_t * pub)
 { return 0; }
 static INLINE int dhd_os_busbusy_wait_condition(dhd_pub_t *pub, uint *var, uint condition)
 { return 0; }
 static INLINE int dhd_os_dmaxfer_wait(dhd_pub_t *pub, uint *condition)
 { return 0; }
 static INLINE int dhd_os_dmaxfer_wake(dhd_pub_t *pub)
 { return 0; }
 static INLINE int dhd_os_busbusy_wait_bitmask(dhd_pub_t *pub, uint *var,
 		uint bitmask, uint condition)
 { return 0; }
 #endif /* LINUX || DHD_EFI */

 int dhd_os_fwboot_intr_wait(dhd_pub_t *pub, uint *condition, uint tmo_ms);
 int dhd_os_fwboot_intr_wake(dhd_pub_t *pub);

 #if defined(__linux__)
 /*
  * Manage sta objects in an interface. Interface is identified by an ifindex and
  * sta(s) within an interfaces are managed using a MacAddress of the sta.
  */
 struct dhd_sta;
 extern bool dhd_sta_associated(dhd_pub_t *dhdp, uint32 bssidx, uint8 *mac);
 extern struct dhd_sta *dhd_find_sta(void *pub, int ifidx, void *ea);
 extern struct dhd_sta *dhd_findadd_sta(void *pub, int ifidx, void *ea);
 extern void dhd_del_all_sta(void *pub, int ifidx);
 extern void dhd_del_sta(void *pub, int ifidx, void *ea);
 extern void dhd_update_sta_chanspec_info(void *pub, int ifidx, const uint8 *ea,
 	chanspec_t chanspec);
 #ifdef WL_MLO
 extern void dhd_update_mlo_peer_info(void *pub, int ifidx, const uint8 *ea,
 	dhd_mlo_peer_info_t *peer_info);
 #endif /* WL_MLO */
 extern bool dhd_is_sta_htput(void *pub, int ifidx, void *ea);
 extern int dhd_get_ap_isolate(dhd_pub_t *dhdp, uint32 idx);
 extern int dhd_set_ap_isolate(dhd_pub_t *dhdp, uint32 idx, int val);
 extern int dhd_bssidx2idx(dhd_pub_t *dhdp, uint32 bssidx);
 extern struct net_device *dhd_linux_get_primary_netdev(dhd_pub_t *dhdp);
 #else /* __linux__ */
 static INLINE bool dhd_sta_associated(dhd_pub_t *dhdp, uint32 bssidx, uint8 *mac)
 { return FALSE;}
 static INLINE void* dhd_find_sta(void *pub, int ifidx, void *ea) { return NULL;}
 static INLINE void *dhd_findadd_sta(void *pub, int ifidx, void *ea) { return NULL; }
 static INLINE void dhd_del_all_sta(void *pub, int ifidx) { }
 static INLINE void dhd_del_sta(void *pub, int ifidx, void *ea) { }
 static INLINE void dhd_update_sta_chanspec_info(void *pub, int ifidx, const uint8 *ea,
 	chanspec_t chanspec) {}
 #ifdef WL_MLO
 static INLINE void dhd_update_mlo_peer_info(void *pub, int ifidx, const uint8 *ea,
 	dhd_mlo_peer_info_t *peer_info) {}
 #endif /* WL_MLO */
 static INLINE bool dhd_is_sta_htput(void *pub, int ifidx, void *ea) { return FALSE; }
 static INLINE int dhd_get_ap_isolate(dhd_pub_t *dhdp, uint32 idx) { return 0; }
 static INLINE int dhd_set_ap_isolate(dhd_pub_t *dhdp, uint32 idx, int val) { return 0; }
 static INLINE int dhd_bssidx2idx(dhd_pub_t *dhdp, uint32 bssidx) { return 0; }
 #endif /* __linux__ */

 #if defined(DHD_FILE_DUMP_EVENT) && defined(DHD_FW_COREDUMP)
 dhd_dongledump_status_t dhd_get_dump_status(dhd_pub_t *pub);
 void dhd_set_dump_status(dhd_pub_t *pub, dhd_dongledump_status_t status);
 #endif /* DHD_FILE_DUMP_EVENT && DHD_FW_COREDUMP */

 extern bool dhd_is_concurrent_mode(dhd_pub_t *dhd);
 int dhd_iovar(dhd_pub_t *pub, int ifidx, char *name, char *param_buf, uint param_len,
 		char *res_buf, uint res_len, bool set);
 extern int dhd_getiovar(dhd_pub_t *pub, int ifidx, char *name, char *cmd_buf,
 		uint cmd_len, char **resptr, uint resp_len);

 #ifdef DHD_MCAST_REGEN
 extern int dhd_get_mcast_regen_bss_enable(dhd_pub_t *dhdp, uint32 idx);
 extern int dhd_set_mcast_regen_bss_enable(dhd_pub_t *dhdp, uint32 idx, int val);
 #endif
 typedef enum cust_gpio_modes {
 	WLAN_RESET_ON,
 	WLAN_RESET_OFF,
 	WLAN_POWER_ON,
 	WLAN_POWER_OFF
 } cust_gpio_modes_t;

 typedef struct dmaxref_mem_map {
 	dhd_dma_buf_t *srcmem;
 	dhd_dma_buf_t *dstmem;
 } dmaxref_mem_map_t;

 #if defined(OEM_ANDROID)
 extern int wl_iw_iscan_set_scan_broadcast_prep(struct net_device *dev, uint flag);
 extern int wl_iw_send_priv_event(struct net_device *dev, char *flag);
 #endif /* defined(OEM_ANDROID) */

 #ifdef DHD_PCIE_NATIVE_RUNTIMEPM
 extern void dhd_flush_rx_tx_wq(dhd_pub_t *dhdp);
 #endif /* DHD_PCIE_NATIVE_RUNTIMEPM */

 #ifdef __linux__
 bool dhd_check_del_in_progress(dhd_pub_t *dhdp, uint8 ifindex);
 #else
 static INLINE bool dhd_check_del_in_progress(dhd_pub_t *dhdp, uint8 ifindex)
 { return FALSE; }
 #endif

 /*
  * Insmod parameters for debug/test
  */

 /* Watchdog timer interval */
 extern uint dhd_watchdog_ms;
 #ifdef DHD_PCIE_RUNTIMEPM
 extern uint dhd_runtimepm_ms;
 #endif /* DHD_PCIE_RUNTIMEPM */

 /* User control for periodic PTM sync feature during init */
 extern int ptm_sync_periodic;

 /** Default console output poll interval */
 extern uint dhd_console_ms;

 #if defined(DHD_DEBUG)
 extern uint wl_msg_level;
 #endif /* defined(DHD_DEBUG) */

 extern uint dhd_slpauto;

 /* Use interrupts */
 extern uint dhd_intr;

 /* Use polling */
 extern uint dhd_poll;

 /* ARP offload agent mode */
 extern uint dhd_arp_mode;

 /* Pkt filte enable control */
 extern uint dhd_pkt_filter_enable;

 /*  Pkt filter init setup */
 extern uint dhd_pkt_filter_init;

 /* Pkt filter mode control */
 extern uint dhd_master_mode;

 /* Roaming mode control */
 extern uint dhd_roam_disable;

 /* Roaming mode control */
 extern uint dhd_radio_up;

 /* TCM verification control */
 extern uint dhd_tcm_test_enable;

 /* TCM test status */
 typedef enum tcm_test_status {
 	TCM_TEST_NOT_RUN = 0,
 	TCM_TEST_FAILED = 1,
 	TCM_TEST_PASSED = 2
 } tcm_test_status_t;
 extern tcm_test_status_t dhd_tcm_test_status;

 /* TCM test mode */
 typedef enum tcm_test_mode {
 	TCM_TEST_MODE_DISABLE = 0,
 	TCM_TEST_MODE_ONCE = 1,
 	TCM_TEST_MODE_ALWAYS = 2
 } tcm_test_mode_t;
 extern tcm_test_mode_t dhd_tcm_test_mode;

 /* Initial idletime ticks (may be -1 for immediate idle, 0 for no idle) */
 extern int dhd_idletime;
 #ifdef DHD_USE_IDLECOUNT
 #define DHD_IDLETIME_TICKS 5
 #else
 #define DHD_IDLETIME_TICKS 1
 #endif /* DHD_USE_IDLECOUNT */

 /* SDIO Drive Strength */
 extern uint dhd_sdiod_drive_strength;

 /* triggers bcm_bprintf to print to kernel log */
 extern bool bcm_bprintf_bypass;

 /* Override to force tx queueing all the time */
 extern uint dhd_force_tx_queueing;

 /* Default bcn_timeout value is 4 */
 #define DEFAULT_BCN_TIMEOUT_VALUE	4
 #ifndef CUSTOM_BCN_TIMEOUT_SETTING
 #define CUSTOM_BCN_TIMEOUT_SETTING	DEFAULT_BCN_TIMEOUT_VALUE
 #endif

 /* Default KEEP_ALIVE Period is 55 sec to prevent AP from sending Keep Alive probe frame */
 #define DEFAULT_KEEP_ALIVE_VALUE 	55000 /* msec */
 #ifndef CUSTOM_KEEP_ALIVE_SETTING
 #define CUSTOM_KEEP_ALIVE_SETTING 	DEFAULT_KEEP_ALIVE_VALUE
 #endif /* DEFAULT_KEEP_ALIVE_VALUE */

 #define NULL_PKT_STR	"null_pkt"

 /* hooks for custom glom setting option via Makefile */
 #define DEFAULT_GLOM_VALUE 	-1
 #ifndef CUSTOM_GLOM_SETTING
 #define CUSTOM_GLOM_SETTING 	DEFAULT_GLOM_VALUE
 #endif
 #define WL_AUTO_ROAM_TRIGGER -75
 /* hooks for custom Roaming Trigger  setting via Makefile */
 #define DEFAULT_ROAM_TRIGGER_VALUE -75 /* dBm default roam trigger all band */
 #define DEFAULT_ROAM_TRIGGER_SETTING 	-1
 #ifndef CUSTOM_ROAM_TRIGGER_SETTING
 #define CUSTOM_ROAM_TRIGGER_SETTING 	DEFAULT_ROAM_TRIGGER_VALUE
 #endif

 /* hooks for custom Roaming Romaing  setting via Makefile */
 #define DEFAULT_ROAM_DELTA_VALUE  10 /* dBm default roam delta all band */
 #define DEFAULT_ROAM_DELTA_SETTING 	-1
 #ifndef CUSTOM_ROAM_DELTA_SETTING
 #define CUSTOM_ROAM_DELTA_SETTING 	DEFAULT_ROAM_DELTA_VALUE
 #endif

 /* hooks for custom PNO Event wake lock to guarantee enough time
 	for the Platform to detect Event before system suspended
 */
 #define DEFAULT_PNO_EVENT_LOCK_xTIME 	2 	/* multiplay of DHD_PACKET_TIMEOUT_MS */
 #ifndef CUSTOM_PNO_EVENT_LOCK_xTIME
 #define CUSTOM_PNO_EVENT_LOCK_xTIME	 DEFAULT_PNO_EVENT_LOCK_xTIME
 #endif
 /* hooks for custom dhd_dpc_prio setting option via Makefile */
 #define DEFAULT_DHP_DPC_PRIO  1
 #ifndef CUSTOM_DPC_PRIO_SETTING
 #define CUSTOM_DPC_PRIO_SETTING 	DEFAULT_DHP_DPC_PRIO
 #endif

 #ifndef CUSTOM_LISTEN_INTERVAL
 #define CUSTOM_LISTEN_INTERVAL 		LISTEN_INTERVAL
 #endif /* CUSTOM_LISTEN_INTERVAL */

 #define DEFAULT_SUSPEND_BCN_LI_DTIM		3
 #ifndef CUSTOM_SUSPEND_BCN_LI_DTIM
 #define CUSTOM_SUSPEND_BCN_LI_DTIM		DEFAULT_SUSPEND_BCN_LI_DTIM
 #endif

 #ifdef OEM_ANDROID
 #ifndef BCN_TIMEOUT_IN_SUSPEND
 #define BCN_TIMEOUT_IN_SUSPEND			6 /* bcn timeout value in suspend mode */
 #endif
 #endif /* OEM_ANDROID */

 #ifndef CUSTOM_RXF_PRIO_SETTING
 #define CUSTOM_RXF_PRIO_SETTING		MAX((CUSTOM_DPC_PRIO_SETTING - 1), 1)
 #endif

 #define DEFAULT_WIFI_TURNOFF_DELAY		0
 #ifndef WIFI_TURNOFF_DELAY
 #define WIFI_TURNOFF_DELAY		DEFAULT_WIFI_TURNOFF_DELAY
 #endif /* WIFI_TURNOFF_DELAY */

 #define DEFAULT_WIFI_TURNON_DELAY		200
 #ifndef WIFI_TURNON_DELAY
 #define WIFI_TURNON_DELAY		DEFAULT_WIFI_TURNON_DELAY
 #endif /* WIFI_TURNON_DELAY */

 #define DEFAULT_DHD_WATCHDOG_INTERVAL_MS	10 /* msec */
 #ifndef CUSTOM_DHD_WATCHDOG_MS
 #define CUSTOM_DHD_WATCHDOG_MS			DEFAULT_DHD_WATCHDOG_INTERVAL_MS
 #endif /* DEFAULT_DHD_WATCHDOG_INTERVAL_MS */

 #if defined(DHD_DEBUG)
 #ifdef OEM_ANDROID
 #define DEFAULT_DHD_CONSOLE_INTERVAL_MS		0 /* android by default disable console msgs */
 #else
 #define DEFAULT_DHD_CONSOLE_INTERVAL_MS		250 /* msec */
 #endif /* OEM_ANDROID */

 #ifndef CUSTOM_DHD_CONSOLE_MS
 #define CUSTOM_DHD_CONSOLE_MS			DEFAULT_DHD_CONSOLE_INTERVAL_MS
 #endif /* DEFAULT_DHD_WATCHDOG_INTERVAL_MS */
 #endif /* DHD_DEBUG */

 #define	DHD_INB_DW_DEASSERT_MS			250

 #define DEFAULT_ASSOC_RETRY_MAX			3
 #ifndef CUSTOM_ASSOC_RETRY_MAX
 #define CUSTOM_ASSOC_RETRY_MAX			DEFAULT_ASSOC_RETRY_MAX
 #endif /* DEFAULT_ASSOC_RETRY_MAX */

 #if defined(BCMSDIO) || defined(DISABLE_FRAMEBURST)
 #define DEFAULT_FRAMEBURST_SET			0
 #else
 #define DEFAULT_FRAMEBURST_SET			1
 #endif /* BCMSDIO */

 #ifndef CUSTOM_FRAMEBURST_SET
 #define CUSTOM_FRAMEBURST_SET			DEFAULT_FRAMEBURST_SET
 #endif /* CUSTOM_FRAMEBURST_SET */

 #ifdef WLTDLS
 #ifndef CUSTOM_TDLS_IDLE_MODE_SETTING
 #define CUSTOM_TDLS_IDLE_MODE_SETTING  60000 /* 60sec to tear down TDLS of not active */
 #endif
 #ifndef CUSTOM_TDLS_RSSI_THRESHOLD_HIGH
 #define CUSTOM_TDLS_RSSI_THRESHOLD_HIGH -70 /* rssi threshold for establishing TDLS link */
 #endif
 #ifndef CUSTOM_TDLS_RSSI_THRESHOLD_LOW
 #define CUSTOM_TDLS_RSSI_THRESHOLD_LOW -80 /* rssi threshold for tearing down TDLS link */
 #endif
 #ifndef CUSTOM_TDLS_PCKTCNT_THRESHOLD_HIGH
 #define CUSTOM_TDLS_PCKTCNT_THRESHOLD_HIGH 100 /* pkt/sec threshold for establishing TDLS link */
 #endif
 #ifndef CUSTOM_TDLS_PCKTCNT_THRESHOLD_LOW
 #define CUSTOM_TDLS_PCKTCNT_THRESHOLD_LOW 10 /* pkt/sec threshold for tearing down TDLS link */
 #endif
 #endif /* WLTDLS */

 #if defined(VSDB) || defined(ROAM_ENABLE)
 #define DEFAULT_BCN_TIMEOUT            6
 #else
 #define DEFAULT_BCN_TIMEOUT            4
 #endif /* CUSTOMER_HW4 && (VSDB || ROAM_ENABLE) */

 #ifndef CUSTOM_BCN_TIMEOUT
 #define CUSTOM_BCN_TIMEOUT             DEFAULT_BCN_TIMEOUT
 #endif

 #define DEFAULT_BCN_TIMEOUT_IN_SUSPEND	10
 #ifndef CUSTOM_BCN_TIMEOUT_IN_SUSPEND
 #define CUSTOM_BCN_TIMEOUT_IN_SUSPEND	DEFAULT_BCN_TIMEOUT_IN_SUSPEND
 #endif /* CUSTOM_BCN_TIMEOUT_IN_SUSPEND */

 #define MAX_DTIM_SKIP_BEACON_INTERVAL	100 /* max allowed associated AP beacon for DTIM skip */
 #ifndef MAX_DTIM_ALLOWED_INTERVAL
 #define MAX_DTIM_ALLOWED_INTERVAL 600 /* max allowed total beacon interval for DTIM skip */
 #endif

 #ifdef OEM_ANDROID
 #ifndef MIN_DTIM_FOR_ROAM_THRES_EXTEND
 #define MIN_DTIM_FOR_ROAM_THRES_EXTEND	600 /* minimum dtim interval to extend roam threshold */
 #endif
 #endif /* OEM_ANDROID */

 #ifdef CONFIG_ROAM_RSSI_LIMIT
 extern int dhd_roam_rssi_limit_get(dhd_pub_t *dhd, int *lmt2g, int *lmt5g);
 extern int dhd_roam_rssi_limit_set(dhd_pub_t *dhd, int lmt2g, int lmt5g);
 #ifndef CUSTOM_ROAMRSSI_2G
 #define CUSTOM_ROAMRSSI_2G		ROAMRSSI_2G_DEFAULT
 #endif /* CUSTOM_ROAMRSSI_2G */
 #ifndef CUSTOM_ROAMRSSI_5G
 #define CUSTOM_ROAMRSSI_5G		ROAMRSSI_5G_DEFAULT
 #endif /* CUSTOM_ROAMRSSI_5G */
 #endif /* CONFIG_ROAM_RSSI_LIMIT */
 #ifdef CONFIG_ROAM_MIN_DELTA
 extern int dhd_roam_min_delta_get(dhd_pub_t *dhd, uint32 *dt2g, uint32 *dt5g);
 extern int dhd_roam_min_delta_set(dhd_pub_t *dhd, uint32 dt2g, uint32 dt5g);
 #ifndef CUSTOM_ROAM_MIN_DELTA
 #define CUSTOM_ROAM_MIN_DELTA		ROAM_MIN_DELTA_DEFAULT
 #endif /* CUSTOM_ROAM_MIN_DELTA */
 #endif /* CONFIG_ROAM_MIN_DELTA */

 #define NO_DTIM_SKIP 1
 #ifdef SDTEST
 /* Echo packet generator (SDIO), pkts/s */
 extern uint dhd_pktgen;

 /* Echo packet len (0 => sawtooth, max 1800) */
 extern uint dhd_pktgen_len;
 #define MAX_PKTGEN_LEN 1800
 #endif

 #ifdef BCMSLTGT
 /* Account for slow hardware (QT) */
 extern uint htclkratio;
 extern int dngl_xtalfreq;
 #endif

 /* optionally set by a module_param_string() */
 #define MOD_PARAM_PATHLEN	2048
 #define MOD_PARAM_INFOLEN	512
 #define MOD_PARAM_SRLEN		64

 #ifdef SOFTAP
 extern char fw_path2[MOD_PARAM_PATHLEN];
 #endif

 #if defined(SUPPORT_MULTIPLE_NVRAM) || defined(SUPPORT_MULTIPLE_CLMBLOB)
 #define MAX_HW_INFO_LEN   10u
 #define MAX_HW_EXT_LEN    (MAX_HW_INFO_LEN * 2)
 #define MAX_FILE_COUNT    8u
 #endif /* SUPPORT_MULTIPLE_NVRAM || SUPPORT_MULTIPLE_CLMBLOB */
 #define MAX_FILE_LEN      90u

 #if defined(CUSTOMER_HW4)
 #define VENDOR_PATH "/vendor"
 #else
 #define VENDOR_PATH ""
 #endif /* CUSTOMER_HW4 */

 /* Platform path Name -
  * Used to find out where to find the FW debug support files.
  * 1) If the Platform Makefile mentions from where it should be
  *    picked from use it.
  * 2) If Platform Makefile does not mention anything,use the
  *    scheme as mapped below
  */
 #if !defined(PLATFORM_PATH)
 /* First Overrides */
 #if defined(DHD_LEGACY_FILE_PATH)
 /* If Legacy file path is to be used */
 #define PLATFORM_PATH	"/data/"
 #elif defined(PLATFORM_SLP)
 /* Path Name for SLP */
 #define PLATFORM_PATH	"/opt/etc/"
 #else
 /* End of Overrides, rely on what is dictated by Android */
 #if defined(CUSTOMER_HW4)
 #define PLATFORM_PATH	"/data/vendor/conn/"
 #else
 #define PLATFORM_PATH	"/data/misc/conn/"
 #endif /* CUSTOMER_HW4  */
 #define DHD_MAC_ADDR_EXPORT
 #define DHD_EXPORT_CNTL_FILE
 #define DHD_SOFTAP_DUAL_IF_INFO
 #define DHD_SEND_HANG_PRIVCMD_ERRORS
 #endif /* DHD_LEGACY_FILE_PATH */
 #endif /* !PLATFORM_PATH */

 #ifdef DHD_MAC_ADDR_EXPORT
 extern struct ether_addr sysfs_mac_addr;
 #endif /* DHD_MAC_ADDR_EXPORT */

 #if defined(__linux__)
 /* Flag to indicate if we should download firmware on driver load */
 extern uint dhd_download_fw_on_driverload;
 extern int allow_delay_fwdl;

 extern int dhd_process_cid_mac(dhd_pub_t *dhdp, bool prepost);
 extern int dhd_write_file(const char *filepath, char *buf, int buf_len);
 extern int dhd_read_file(const char *filepath, char *buf, int buf_len);
 extern int dhd_write_file_and_check(const char *filepath, char *buf, int buf_len);
 extern int dhd_file_delete(char *path);

 #ifdef READ_MACADDR
 extern int dhd_set_macaddr_from_file(dhd_pub_t *dhdp);
 #else
 static INLINE int dhd_set_macaddr_from_file(dhd_pub_t *dhdp) { return 0; }
 #endif /* READ_MACADDR */
 #ifdef WRITE_MACADDR
 extern int dhd_write_macaddr(struct ether_addr *mac);
 #else
 static INLINE int dhd_write_macaddr(struct ether_addr *mac) { return 0; }
 #endif /* WRITE_MACADDR */

 #if defined(USE_CID_CHECK) || defined(USE_DIRECT_VID_TAG)
 #define DHD_USE_CISINFO_FROM_OTP
 /* For COB, can't check CID/MAC in OTP, so, define it here */
 #define DHD_READ_CIS_FROM_BP
 #define MAX_VNAME_LEN		64
 #define MAX_VID_LEN		8
 #define MODULE_NAME_INDEX_MAX	3
 #define MAX_EXTENSION 20
 typedef struct {
 	char cid_ext[MAX_EXTENSION];
 	char nvram_ext[MAX_EXTENSION];
 	char fw_ext[MAX_EXTENSION];
 } naming_info_t;
 extern uint32 cur_vid_info;
 #ifdef DHD_EXPORT_CNTL_FILE
 extern char cidinfostr[MAX_VNAME_LEN];
 #endif /* DHD_EXPORT_CNTL_FILE */
 extern int dhd_check_module_cid(dhd_pub_t *dhdp);
 #else
 static INLINE int dhd_check_module_cid(dhd_pub_t *dhdp) { return 0; }
 #endif /* USE_CID_CHECK || USE_DIRECT_VID_TAG */
 #ifdef USE_CID_CHECK
 extern char *dhd_get_cid_info(unsigned char *vid, int vid_length,
 	void *vid_table, uint vid_table_sz);
 #endif /* USE_CID_CHECK */
 #ifdef GET_MAC_FROM_OTP
 extern int dhd_check_module_mac(dhd_pub_t *dhdp);
 #else
 static INLINE int dhd_check_module_mac(dhd_pub_t *dhdp) { return 0; }
 #endif /* GET_MAC_FROM_OTP */

 #if defined(READ_MACADDR) || defined(WRITE_MACADDR) || defined(USE_CID_CHECK) || \
 	defined(GET_MAC_FROM_OTP)
 #define DHD_USE_CISINFO
 #endif /* READ_MACADDR || WRITE_MACADDR || USE_CID_CHECK || GET_MAC_FROM_OTP */

 #ifdef DHD_USE_CISINFO
 int dhd_read_otp_sw_rgn(dhd_pub_t *dhdp);
 void dhd_clear_cis(dhd_pub_t *dhdp);
 int dhd_alloc_cis(dhd_pub_t *dhdp);
 #if defined(SUPPORT_MULTIPLE_MODULE_CIS) && defined(USE_CID_CHECK)
 extern int dhd_check_module_b85a(void);
 extern int dhd_check_module_b90(void);
 #define BCM4359_MODULE_TYPE_B90B 1
 #define BCM4359_MODULE_TYPE_B90S 2
 #endif /* defined(SUPPORT_MULTIPLE_MODULE_CIS) && defined(USE_CID_CHECK) */
 #if defined(USE_CID_CHECK)
 extern int dhd_check_module_bcm(char *module_type, int index, bool *is_murata_fem);
 extern naming_info_t *
 dhd_find_naming_info(dhd_pub_t *dhdp, char *module_type);
 extern naming_info_t * dhd_find_naming_info_by_chip_rev(dhd_pub_t *dhdp, bool *is_murata_fem);
 int dhd_get_fw_nvram_names(dhd_pub_t *dhdp, uint chipid, uint chiprev,
 	char *fw_path, char *nv_path, char *map_path);
 int dhd_get_complete_blob_name(dhd_pub_t *dhdp, char *blob_path, char *blob_name);
 #endif /* defined(USE_CID_CHECK) */
 #ifdef USE_DIRECT_VID_TAG
 #define VENDOR_OFF 1
 #define MD_REV_OFF 0
 #define A0_REV "_a0"
 #define B0_REV "_b0"
 #define C0_REV "_c0"
 #define C1_REV "_c1"
 extern int dhd_check_stored_module_info(char *vid);
 extern int concate_nvram_by_vid(dhd_pub_t *dhdp, char *nv_path, char *chipstr);
 #endif /* USE_DIRECT_VID_TAG */
 #if defined(USE_CID_CHECK) && defined(USE_DIRECT_VID_TAG)
 #error Please use USE_CID_CHECK/USE_DIRECT_VID_TAG exclusively
 #endif /* USE_CID_CHECK && USE_DIRECT_VID_TAG */
 #else
 static INLINE int dhd_read_otp_sw_rgn(dhd_pub_t *dhdp) { return 0; }
 static INLINE void dhd_clear_cis(dhd_pub_t *dhdp) { }
 static INLINE int dhd_alloc_cis(dhd_pub_t *dhdp) { return 0; }
 #endif /* DHD_USE_CISINFO */

 #else /* __linux__ */
 static INLINE int dhd_process_cid_mac(dhd_pub_t *dhdp, bool prepost) { return 0; }
 #endif /* __linux__ */

 #if defined(WL_CFG80211) && defined(SUPPORT_DEEP_SLEEP)
 /* Flags to indicate if we distingish power off policy when
  * user set the memu "Keep Wi-Fi on during sleep" to "Never"
  */
 extern int trigger_deep_sleep;
 int dhd_deepsleep(struct net_device *dev, int flag);
 #endif /* WL_CFG80211 && SUPPORT_DEEP_SLEEP */

 extern void dhd_wait_for_event(dhd_pub_t *dhd, bool *lockvar);
 extern void dhd_wait_event_wakeup(dhd_pub_t*dhd);

 #define IFLOCK_INIT(lock)       *lock = 0
 #define IFLOCK(lock)    while (InterlockedCompareExchange((lock), 1, 0))	\
 	NdisStallExecution(1);
 #define IFUNLOCK(lock)  InterlockedExchange((lock), 0)
 #define IFLOCK_FREE(lock)
 #define FW_SUPPORTED(dhd, capa) ((strstr(dhd->fw_capabilities, " " #capa " ") != NULL))
 #ifdef ARP_OFFLOAD_SUPPORT
 #define MAX_IPV4_ENTRIES	8
 void dhd_arp_offload_set(dhd_pub_t * dhd, int arp_mode);
 void dhd_arp_offload_enable(dhd_pub_t * dhd, int arp_enable);

 /* dhd_commn arp offload wrapers */
 void dhd_aoe_hostip_clr(dhd_pub_t *dhd, int idx);
 void dhd_aoe_arp_clr(dhd_pub_t *dhd, int idx);
 int dhd_arp_get_arp_hostip_table(dhd_pub_t *dhd, void *buf, int buflen, int idx);
 void dhd_arp_offload_add_ip(dhd_pub_t *dhd, uint32 ipaddr, int idx);
 #endif /* ARP_OFFLOAD_SUPPORT */


 #ifdef WLTDLS
 int dhd_tdls_enable(struct net_device *dev, bool tdls_on, bool auto_on, struct ether_addr *mac);
 int dhd_tdls_set_mode(dhd_pub_t *dhd, bool wfd_mode);
 #ifdef PCIE_FULL_DONGLE
 int dhd_tdls_update_peer_info(dhd_pub_t *dhdp, wl_event_msg_t *event);
 int dhd_tdls_event_handler(dhd_pub_t *dhd_pub, wl_event_msg_t *event);
 int dhd_free_tdls_peer_list(dhd_pub_t *dhd_pub);
 #endif /* PCIE_FULL_DONGLE */
 #endif /* WLTDLS */

 /* Neighbor Discovery Offload Support */
 extern int dhd_ndo_enable(dhd_pub_t * dhd, int ndo_enable);
 int dhd_ndo_add_ip(dhd_pub_t *dhd, char* ipaddr, int idx);
 int dhd_ndo_remove_ip(dhd_pub_t *dhd, int idx);

 /* Enhanced ND offload support */
 uint16 dhd_ndo_get_version(dhd_pub_t *dhdp);
 int dhd_ndo_add_ip_with_type(dhd_pub_t *dhdp, char *ipv6addr, uint8 type, int idx);
 int dhd_ndo_remove_ip_by_addr(dhd_pub_t *dhdp, char *ipv6addr, int idx);
 int dhd_ndo_remove_ip_by_type(dhd_pub_t *dhdp, uint8 type, int idx);
 int dhd_ndo_unsolicited_na_filter_enable(dhd_pub_t *dhdp, int enable);

 /* ioctl processing for nl80211 */
 int dhd_ioctl_process(dhd_pub_t *pub, int ifidx, struct dhd_ioctl *ioc, void *data_buf);

 #if defined(SUPPORT_MULTIPLE_REVISION)
 extern int
 concate_revision(struct dhd_bus *bus, char *fwpath, char *nvpath);
 #endif /* SUPPORT_MULTIPLE_REVISION */
 void dhd_bus_update_fw_nv_path(struct dhd_bus *bus, char *pfw_path, char *pnv_path);
 void dhd_set_bus_state(void *bus, uint32 state);

 /* Remove proper pkts(either one no-frag pkt or whole fragmented pkts) */
 typedef int (*f_droppkt_t)(dhd_pub_t *dhdp, int prec, void* p, bool bPktInQ);
 extern bool dhd_prec_drop_pkts(dhd_pub_t *dhdp, struct pktq *pq, int prec, f_droppkt_t fn);

 extern const uint8 wme_fifo2ac[];
 extern const uint8 prio2fifo[];
 #ifdef PROP_TXSTATUS
 int dhd_os_wlfc_block(dhd_pub_t *pub);
 int dhd_os_wlfc_unblock(dhd_pub_t *pub);
 #endif /* PROP_TXSTATUS */

 int dhd_os_socram_dump(struct net_device *dev, uint32 *dump_size);
 int dhd_os_get_socram_dump(struct net_device *dev, char **buf, uint32 *size);
 int dhd_common_socram_dump(dhd_pub_t *dhdp);

 int dhd_dump(dhd_pub_t *dhdp, char *buf, int buflen);
 int dhd_counters(dhd_pub_t *dhdp, char *buf, int buflen);

 int dhd_os_get_version(struct net_device *dev, bool dhd_ver, char **buf, uint32 size);
 void dhd_get_memdump_filename(struct net_device *ndev, char *memdump_path, int len, char *fname);
 uint8* dhd_os_prealloc(dhd_pub_t *dhdpub, int section, uint size, bool kmalloc_if_fail);
 void dhd_os_prefree(dhd_pub_t *dhdpub, void *addr, uint size);

 #if defined(CONFIG_DHD_USE_STATIC_BUF)
 #define DHD_OS_PREALLOC(dhdpub, section, size) dhd_os_prealloc(dhdpub, section, size, FALSE)
 #define DHD_OS_PREFREE(dhdpub, addr, size) dhd_os_prefree(dhdpub, addr, size)
 #else
 #define DHD_OS_PREALLOC(dhdpub, section, size) MALLOC(dhdpub->osh, size)
 #define DHD_OS_PREFREE(dhdpub, addr, size) MFREE(dhdpub->osh, addr, size)
 #endif /* defined(CONFIG_DHD_USE_STATIC_BUF) */

 #ifdef USE_WFA_CERT_CONF
 enum {
 	SET_PARAM_BUS_TXGLOM_MODE,
 	SET_PARAM_ROAMOFF,
 #ifdef USE_WL_FRAMEBURST
 	SET_PARAM_FRAMEBURST,
 #endif /* USE_WL_FRAMEBURST */
 #ifdef USE_WL_TXBF
 	SET_PARAM_TXBF,
 #endif /* USE_WL_TXBF */
 #ifdef PROP_TXSTATUS
 	SET_PARAM_PROPTX,
 	SET_PARAM_PROPTXMODE,
 #endif /* PROP_TXSTATUS */
 	PARAM_LAST_VALUE
 };
 extern int sec_get_param_wfa_cert(dhd_pub_t *dhd, int mode, uint* read_val);
 #ifdef DHD_EXPORT_CNTL_FILE
 #define VALUENOTSET 0xFFFFFFFFu
 extern uint32 bus_txglom;
 extern uint32 roam_off;
 #ifdef USE_WL_FRAMEBURST
 extern uint32 frameburst;
 #endif /* USE_WL_FRAMEBURST */
 #ifdef USE_WL_TXBF
 extern uint32 txbf;
 #endif /* USE_WL_TXBF */
 #ifdef PROP_TXSTATUS
 extern uint32 proptx;
 #endif /* PROP_TXSTATUS */
 #endif /* DHD_EXPORT_CNTL_FILE */
 #endif /* USE_WFA_CERT_CONF */

 #if defined(BCM_ROUTER_DHD)
 #if defined(HNDCTF)
 bool dhd_ctf_hotbrc_check(dhd_pub_t *dhdp, uint8 *eh, int ifidx);
 void dhd_ctf_dump(dhd_pub_t *dhdp, struct bcmstrbuf *strbuf);
 bool dhd_l2_filter_chainable(dhd_pub_t *dhdp, uint8 *eh, int ifidx);
 bool dhd_wet_chainable(dhd_pub_t *dhdap);
 bool dhd_rx_pkt_chainable(dhd_pub_t *dhdp, int ifidx);
 #endif /* HNDCTF */
 extern void dhd_schedule_trap_log_dump(dhd_pub_t *dhdp,
 	uint8 *buf, uint32 size);
 /* When a new flowid is allocated/deallocated, inform dhd. */
 extern void dhd_add_flowid(dhd_pub_t * dhdp, int ifidx,
                           uint8 ac_prio, void * ea, uint16 flowid);
 extern void dhd_del_flowid(dhd_pub_t * dhdp, int ifidx, uint16 flowid);
 #else  /* ! BCM_ROUTER_DHD */
 #define dhd_add_flowid(pub, ifidx, ac_prio, ea, flowid)  do {} while (0)
 #define dhd_del_flowid(pub, ifidx, flowid)               do {} while (0)
 bool dhd_wet_chainable(dhd_pub_t *dhdp);
 #endif /* ! BCM_ROUTER_DHD */

 extern unsigned long dhd_os_general_spin_lock(dhd_pub_t *pub);
 extern void dhd_os_general_spin_unlock(dhd_pub_t *pub, unsigned long flags);

 /** Miscellaenous DHD Spin Locks */

 /* Enable DHD general spin lock/unlock */
 #define DHD_GENERAL_LOCK(dhdp, flags) \
 	(flags) = dhd_os_general_spin_lock(dhdp)
 #define DHD_GENERAL_UNLOCK(dhdp, flags) \
 	dhd_os_general_spin_unlock((dhdp), (flags))

 /* Enable DHD timer spin lock/unlock */
 #define DHD_TIMER_LOCK(lock, flags)     (flags) = osl_spin_lock(lock)
 #define DHD_TIMER_UNLOCK(lock, flags)   osl_spin_unlock(lock, (flags))

 /* Enable DHD flowring spin lock/unlock */
 #define DHD_FLOWRING_LOCK(lock, flags)     (flags) = osl_spin_lock(lock)
 #define DHD_FLOWRING_UNLOCK(lock, flags)   osl_spin_unlock((lock), (flags))

 /* Enable DHD common flowring info spin lock/unlock */
 #define DHD_FLOWID_LOCK(lock, flags)       (flags) = osl_spin_lock(lock)
 #define DHD_FLOWID_UNLOCK(lock, flags)     osl_spin_unlock((lock), (flags))

 /* Enable DHD common flowring list spin lock/unlock */
 #define DHD_FLOWRING_LIST_LOCK(lock, flags)       (flags) = osl_spin_lock(lock)
 #define DHD_FLOWRING_LIST_UNLOCK(lock, flags)     osl_spin_unlock((lock), (flags))

 #define DHD_RING_LOCK(lock, flags)	(flags) = osl_spin_lock(lock)
 #define DHD_RING_UNLOCK(lock, flags)	osl_spin_unlock((lock), (flags))

 #define DHD_BUS_LP_STATE_LOCK(lock, flags)	(flags) = osl_spin_lock(lock)
 #define DHD_BUS_LP_STATE_UNLOCK(lock, flags)	osl_spin_unlock((lock), (flags))

 #define DHD_BAR1_SWITCH_LOCK(lock, flags)	(flags) = osl_spin_lock(lock)
 #define DHD_BAR1_SWITCH_UNLOCK(lock, flags)	osl_spin_unlock((lock), (flags))

 #define DHD_BAR2_SWITCH_LOCK(lock, flags)   (flags) = osl_spin_lock(lock)
 #define DHD_BAR2_SWITCH_UNLOCK(lock, flags) osl_spin_unlock((lock), (flags))

 #define DHD_BUS_PWR_REQ_LOCK(lock, flags)	(flags) = osl_spin_lock(lock)
 #define DHD_BUS_PWR_REQ_UNLOCK(lock, flags)	osl_spin_unlock((lock), (flags))

 #ifdef PCIE_INB_DW
 #define DHD_BUS_DONGLE_DS_LOCK(lock, flags)	(flags) = osl_spin_lock(lock)
 #define DHD_BUS_DONGLE_DS_UNLOCK(lock, flags)	osl_spin_unlock((lock), (flags))
 #endif /* PCIE_INB_DW */

 /* Enable DHD backplane spin lock/unlock */
 #define DHD_BACKPLANE_ACCESS_LOCK(lock, flags)     (flags) = osl_spin_lock(lock)
 #define DHD_BACKPLANE_ACCESS_UNLOCK(lock, flags)   osl_spin_unlock((lock), (flags))

 #define DHD_BUS_INB_DW_LOCK(lock, flags)	(flags) = osl_spin_lock(lock)
 #define DHD_BUS_INB_DW_UNLOCK(lock, flags)	osl_spin_unlock((lock), (flags))

 /* Enable DHD TDLS peer list spin lock/unlock */
 #ifdef WLTDLS
 #define DHD_TDLS_LOCK(lock, flags)       (flags) = osl_spin_lock(lock)
 #define DHD_TDLS_UNLOCK(lock, flags)     osl_spin_unlock((lock), (flags))
 #endif /* WLTDLS */

 #define DHD_BUS_INB_DW_LOCK(lock, flags)	(flags) = osl_spin_lock(lock)
 #define DHD_BUS_INB_DW_UNLOCK(lock, flags)	osl_spin_unlock((lock), (flags))

 #ifdef DBG_PKT_MON
 /* Enable DHD PKT MON spin lock/unlock */
 #define DHD_PKT_MON_LOCK(lock, flags)     (flags) = osl_spin_lock(lock)
 #define DHD_PKT_MON_UNLOCK(lock, flags)   osl_spin_unlock(lock, (flags))
 #endif /* DBG_PKT_MON */

 #ifdef DHD_PKT_LOGGING
 /* Enable DHD PKT LOG spin lock/unlock */
 #define DHD_PKT_LOG_LOCK(lock, flags)     (flags) = osl_spin_lock(lock)
 #define DHD_PKT_LOG_UNLOCK(lock, flags)   osl_spin_unlock(lock, (flags))
 #endif /* DHD_PKT_LOGGING */


 #if defined(__linux__)
 #define DHD_LINUX_GENERAL_LOCK(dhdp, flags)	DHD_GENERAL_LOCK(dhdp, flags)
 #define DHD_LINUX_GENERAL_UNLOCK(dhdp, flags)	DHD_GENERAL_UNLOCK(dhdp, flags)
 #else
 #define DHD_LINUX_GENERAL_LOCK(dhdp, flags)	do {BCM_REFERENCE(flags);} while (0)
 #define DHD_LINUX_GENERAL_UNLOCK(dhdp, flags)	do {BCM_REFERENCE(flags);} while (0)
 #endif

 #if defined(DHD_TIMESYNC)
 #define DHD_TIMESYNC_LOCK(lock, flags)		(flags) = osl_spin_lock(lock)
 #define DHD_TIMESYNC_UNLOCK(lock, flags)	osl_spin_unlock(lock, (flags))
 #else
 #define DHD_TIMESYNC_LOCK(lock, flags)		do {BCM_REFERENCE(flags);} while (0)
 #define DHD_TIMESYNC_UNLOCK(lock, flags)	do {BCM_REFERENCE(flags);} while (0)
 #endif /* DHD_TIMESYNC */

 #define DHD_BUS_INB_DW_LOCK(lock, flags)	(flags) = osl_spin_lock(lock)
 #define DHD_BUS_INB_DW_UNLOCK(lock, flags)	osl_spin_unlock((lock), (flags))

 #define DHD_RX_NAPI_QUEUE_LOCK(lock, flags)	(flags) = osl_spin_lock(lock)
 #define DHD_RX_NAPI_QUEUE_UNLOCK(lock, flags)	osl_spin_unlock((lock), (flags))

 #define DHD_UP_LOCK(lock, flags)	(flags) = osl_spin_lock(lock)
 #define DHD_UP_UNLOCK(lock, flags)	osl_spin_unlock((lock), (flags))

 #define DHD_WAKE_SPIN_LOCK(lock, flags)	(flags) = osl_spin_lock(lock)
 #define DHD_WAKE_SPIN_UNLOCK(lock, flags)	osl_spin_unlock((lock), (flags))

 /*
  * Temporarily change log dump lock to spin_lock_irqsave as DHD_ERROR/DHD_LOG_MEM
  * are being called from dhdpcie_bus_isr.
  * This will be reverted after proper solution is implemented to handle isr prints
  */
 #define DHD_LOG_DUMP_BUF_LOCK(lock, flags)	(flags) = osl_spin_lock_irq(lock)
 #define DHD_LOG_DUMP_BUF_UNLOCK(lock, flags)	osl_spin_unlock_irq((lock), (flags))

 #define DHD_PKT_WAKE_LOCK(lock, flags)	(flags) = osl_spin_lock(lock)
 #define DHD_PKT_WAKE_UNLOCK(lock, flags)	osl_spin_unlock((lock), (flags))

 /* wlan_oob_irq is called in hard irq context */
 #define DHD_OOB_IRQ_LOCK(lock, flags)	(flags) = osl_spin_lock_irq(lock)
 #define DHD_OOB_IRQ_UNLOCK(lock, flags)	osl_spin_unlock_irq((lock), (flags))

 #define DHD_IF_STA_LIST_LOCK(lock, flags)	(flags) = osl_spin_lock(lock)
 #define DHD_IF_STA_LIST_UNLOCK(lock, flags)	osl_spin_unlock((lock), (flags))

 #define DHD_DBG_RING_LOCK_INIT(osh)		osl_spin_lock_init(osh)
 #define DHD_DBG_RING_LOCK_DEINIT(osh, lock)	osl_spin_lock_deinit(osh, (lock))
 #define DHD_DBG_RING_LOCK(lock, flags)		(flags) = osl_spin_lock(lock)
 #define DHD_DBG_RING_UNLOCK(lock, flags)	osl_spin_unlock((lock), flags)

 #ifdef DHD_MEM_STATS
 /* memory stats lock/unlock */
 #define DHD_MEM_STATS_LOCK(lock, flags)     (flags) = osl_spin_lock(lock)
 #define DHD_MEM_STATS_UNLOCK(lock, flags)   osl_spin_unlock((lock), (flags))
 #endif /* DHD_MEM_STATS */

 #if defined(DHD_MESH)
 /* MESH Routing Table lock, protect between IOCTL aka user process vs Data path contexts */
 #define DHD_MESH_RT_TABLE_LOCK(lock, flags)       (flags) = osl_spin_lock(lock)
 #define DHD_MESH_RT_TABLE_UNLOCK(lock, flags)     osl_spin_unlock((lock), (flags))
 #endif /* defined(DHD_MESH) */

 extern void dhd_dump_to_kernelog(dhd_pub_t *dhdp);

 #if defined(__linux__)
 extern void dhd_print_tasklet_status(dhd_pub_t *dhd);
 extern bool dhd_check_cfg_in_progress(dhd_pub_t *dhdp);
 #else
 static INLINE void dhd_print_tasklet_status(dhd_pub_t *dhd) { }
 static INLINE bool dhd_check_cfg_in_progress(dhd_pub_t *dhdp)
 { return FALSE; }
 #endif /* __linux__ */

 #ifdef DHD_L2_FILTER
 extern int dhd_get_parp_status(dhd_pub_t *dhdp, uint32 idx);
 extern int dhd_set_parp_status(dhd_pub_t *dhdp, uint32 idx, int val);
 extern int dhd_get_dhcp_unicast_status(dhd_pub_t *dhdp, uint32 idx);
 extern int dhd_set_dhcp_unicast_status(dhd_pub_t *dhdp, uint32 idx, int val);
 extern int dhd_get_block_ping_status(dhd_pub_t *dhdp, uint32 idx);
 extern int dhd_set_block_ping_status(dhd_pub_t *dhdp, uint32 idx, int val);
 extern int dhd_get_grat_arp_status(dhd_pub_t *dhdp, uint32 idx);
 extern int dhd_set_grat_arp_status(dhd_pub_t *dhdp, uint32 idx, int val);
 extern int dhd_get_block_tdls_status(dhd_pub_t *dhdp, uint32 idx);
 extern int dhd_set_block_tdls_status(dhd_pub_t *dhdp, uint32 idx, int val);
 #endif /* DHD_L2_FILTER */

 #if (defined(BCM_ROUTER_DHD) && defined(QOS_MAP_SET))
 extern int dhd_set_qosmap_up_table(dhd_pub_t *dhdp, uint32 idx, bcm_tlv_t *qos_map_ie);
 #endif /* BCM_ROUTER_DHD && QOS_MAP_SET */

 typedef struct wl_io_pport {
 	dhd_pub_t *dhd_pub;
 	uint ifidx;
 } wl_io_pport_t;

 typedef struct wl_evt_pport {
 	dhd_pub_t *dhd_pub;
 	int *ifidx;
 	void *pktdata;
 	uint data_len;
 	void **data_ptr;
 	void *raw_event;
 } wl_evt_pport_t;

 extern void *dhd_pub_shim(dhd_pub_t *dhd_pub);
 #ifdef DHD_FW_COREDUMP
 void* dhd_get_fwdump_buf(dhd_pub_t *dhd_pub, uint32 length);
 #endif /* DHD_FW_COREDUMP */

 int dhd_get_download_buffer(dhd_pub_t	*dhd, char *file_path, download_type_t component,
 	char ** buffer, int *length);

 void dhd_free_download_buffer(dhd_pub_t	*dhd, void *buffer, int length);

 int dhd_download_blob(dhd_pub_t *dhd, unsigned char *buf,
 	uint32 len, char *iovar, int ifidx);

 int dhd_download_blob_cached(dhd_pub_t *dhd, char *file_path,
 	uint32 len, char *iovar);

 int dhd_apply_default_txcap(dhd_pub_t *dhd, char *txcap_path);
 int dhd_apply_default_clm(dhd_pub_t *dhd, char *clm_path);

 #ifdef SHOW_LOGTRACE
 #if defined(__linux__) || defined(DHD_EFI)
 int dhd_parse_logstrs_file(osl_t *osh, char *raw_fmts, int logstrs_size,
 		dhd_event_log_fmt_t *log_fmt);
 #else
 int dhd_parse_logstrs_file(osl_t *osh, char *raw_fmts, int logstrs_size,
 		dhd_event_log_t *event_log);
 #endif /* __linux__ || DHD_EFI */
 int dhd_parse_map_file(osl_t *osh, void *file, uint32 *ramstart,
 		uint32 *rodata_start, uint32 *rodata_end);
 #ifdef PCIE_FULL_DONGLE
 int dhd_event_logtrace_infobuf_pkt_process(dhd_pub_t *dhdp, void *pktbuf,
 		dhd_event_log_t *event_data);
 #endif /* PCIE_FULL_DONGLE */
 #endif /* SHOW_LOGTRACE */

 /*
  * control_logtrace:
  * "0" -> do not print event log messages in any form
  * "1" -> print event log messages as EL
  * "2" -> print event log messages as formatted CONSOLE_E if logstrs.bin etc. files are available
  */
 typedef enum logtrace_ctrl {
 	LOGTRACE_DISABLE = 0,
 	LOGTRACE_RAW_FMT = 1,
 	LOGTRACE_PARSED_FMT = 2
 } logtrace_ctrl_t;

 #define DEFAULT_CONTROL_LOGTRACE	LOGTRACE_PARSED_FMT
 #ifndef CUSTOM_CONTROL_LOGTRACE
 #define CUSTOM_CONTROL_LOGTRACE		DEFAULT_CONTROL_LOGTRACE
 #endif

 extern uint8 control_logtrace;

 #ifdef BTLOG
 int dhd_bt_log_pkt_process(dhd_pub_t *dhdp, void *pktbuf);
 #endif	/* BTLOG */

 #if defined(NDIS)
 bool dhd_is_device_removed(dhd_pub_t *dhd);
 #else
 #define dhd_is_device_removed(x) FALSE
 #define dhd_os_ind_firmware_stall(x)
 #endif /* defined(NDIS) */

 #if defined(DHD_FW_COREDUMP)
 #if defined(__linux__)
 extern void dhd_get_memdump_info(dhd_pub_t *dhd);
 #else
 static INLINE void dhd_get_memdump_info(dhd_pub_t *dhd)
 { return; }
 #endif /* __linux__ */
 #endif /* defined(DHD_FW_COREDUMP) */
 #ifdef BCMASSERT_LOG
 extern void dhd_get_assert_info(dhd_pub_t *dhd);
 #else
 static INLINE void dhd_get_assert_info(dhd_pub_t *dhd) { }
 #endif /* BCMASSERT_LOG */

 #if defined(__linux__)
 #define DMAXFER_FREE(dhdp, dmap) dhd_schedule_dmaxfer_free(dhdp, dmap);
 #else  /* !__linux__ */
 #define DMAXFER_FREE(dhdp, dmmap) dmaxfer_free_prev_dmaaddr(dhdp, dmmap);
 #endif  /* __linux__ */

 #if defined(PCIE_FULL_DONGLE)
 extern void dmaxfer_free_prev_dmaaddr(dhd_pub_t *dhdp, dmaxref_mem_map_t *dmmap);
 void dhd_schedule_dmaxfer_free(dhd_pub_t *dhdp, dmaxref_mem_map_t *dmmap);

 extern int ring_size_version;
 extern int ring_size_alloc_version;

 extern uint h2d_max_txpost;
 extern uint h2d_htput_max_txpost;
 extern uint d2h_max_txcpl;

 extern uint h2d_max_rxpost;
 extern uint d2h_max_rxcpl;

 extern uint h2d_max_ctrlpost;
 extern uint d2h_max_ctrlcpl;

 extern uint rx_buf_burst;
 extern uint rx_bufpost_threshold;

 extern uint flowring_bkp_qsize;
 #endif  /* PCIE_FULL_DONGLE */

 #define DHD_LB_STATS_NOOP	do { /* noop */ } while (0)
 #if defined(DHD_LB_STATS)
 #include <bcmutils.h>
 extern void dhd_lb_stats_init(dhd_pub_t *dhd);
 extern void dhd_lb_stats_deinit(dhd_pub_t *dhd);
 extern void dhd_lb_stats_reset(dhd_pub_t *dhd);
 #ifdef DHD_MEM_STATS
 extern uint64 dhd_lb_mem_usage(dhd_pub_t *dhdp, struct bcmstrbuf *strbuf);
 #endif /* DHD_MEM_STATS */
 extern void dhd_lb_stats_dump(dhd_pub_t *dhdp, struct bcmstrbuf *strbuf);
 extern void dhd_lb_stats_update_napi_histo(dhd_pub_t *dhdp, uint32 count);
 extern void dhd_lb_stats_update_txc_histo(dhd_pub_t *dhdp, uint32 count);
 extern void dhd_lb_stats_update_rxc_histo(dhd_pub_t *dhdp, uint32 count);
 extern void dhd_lb_stats_txc_percpu_cnt_incr(dhd_pub_t *dhdp);
 extern void dhd_lb_stats_rxc_percpu_cnt_incr(dhd_pub_t *dhdp);
 #define DHD_LB_STATS_INIT(dhdp)	dhd_lb_stats_init(dhdp)
 #define DHD_LB_STATS_DEINIT(dhdp) dhd_lb_stats_deinit(dhdp)
 /* Reset is called from common layer so it takes dhd_pub_t as argument */
 #define DHD_LB_STATS_RESET(dhdp) dhd_lb_stats_reset(dhdp)
 #define DHD_LB_STATS_CLR(x)	(x) = 0U
 #define DHD_LB_STATS_INCR(x)	(x) = (x) + 1
 #define DHD_LB_STATS_ADD(x, c)	(x) = (x) + (c)
 #define DHD_LB_STATS_PERCPU_ARR_INCR(x) \
 	{ \
 		int cpu = get_cpu(); put_cpu(); \
 		DHD_LB_STATS_INCR(x[cpu]); \
 	}
 #define DHD_LB_STATS_UPDATE_NAPI_HISTO(dhdp, x)	dhd_lb_stats_update_napi_histo(dhdp, x)
 #else /* !DHD_LB_STATS */
 #define DHD_LB_STATS_INIT(dhdp)	 DHD_LB_STATS_NOOP
 #define DHD_LB_STATS_DEINIT(dhdp) DHD_LB_STATS_NOOP
 #define DHD_LB_STATS_RESET(dhdp) DHD_LB_STATS_NOOP
 #define DHD_LB_STATS_CLR(x)	 DHD_LB_STATS_NOOP
 #define DHD_LB_STATS_INCR(x)	 DHD_LB_STATS_NOOP
 #define DHD_LB_STATS_ADD(x, c)	 DHD_LB_STATS_NOOP
 #define DHD_LB_STATS_PERCPU_ARR_INCR(x)	 DHD_LB_STATS_NOOP
 #define DHD_LB_STATS_UPDATE_NAPI_HISTO(dhd, x) DHD_LB_STATS_NOOP
 #endif /* !DHD_LB_STATS */

 #ifdef BCMDBG
 extern void dhd_schedule_macdbg_dump(dhd_pub_t *dhdp);
 #endif /* BCMDBG */

 #ifndef DHD_SSSR_DUMP
 #define DHD_SSSR_MEMPOOL_INIT(dhdp)		do { /* noop */ } while (0)
 #define DHD_SSSR_MEMPOOL_DEINIT(dhdp)		do { /* noop */ } while (0)
 #define DHD_SSSR_DUMP_INIT(dhdp)		do { /* noop */ } while (0)
 #define DHD_SSSR_DUMP_DEINIT(dhdp)		do { /* noop */ } while (0)
 #define DHD_SSSR_PRINT_FILEPATH(dhdp, path)	do { /* noop */ } while (0)
 #define DHD_SSSR_REG_INFO_INIT(dhdp)		do { /* noop */ } while (0)
 #define DHD_SSSR_REG_INFO_DEINIT(dhdp)		do { /* noop */ } while (0)
 #endif /* !DHD_SSSR_DUMP */

 #ifdef DHD_SDTC_ETB_DUMP
 #define DHD_SDTC_ETB_MEMPOOL_SIZE (64 * 1024)
 extern int dhd_sdtc_etb_mempool_init(dhd_pub_t *dhd);
 extern void dhd_sdtc_etb_mempool_deinit(dhd_pub_t *dhd);
 extern void dhd_sdtc_etb_init(dhd_pub_t *dhd);
 extern void dhd_sdtc_etb_deinit(dhd_pub_t *dhd);
 extern void dhd_sdtc_etb_dump(dhd_pub_t *dhd);
 extern int dhd_sdtc_etb_hal_file_dump(void *dhd_pub, const void *user_buf, uint32 len);
 #endif /* DHD_SDTC_ETB_DUMP */

 #ifdef DHD_COREDUMP
 extern int dhd_coredump_mempool_init(dhd_pub_t *dhd);
 extern void dhd_coredump_mempool_deinit(dhd_pub_t *dhd);
 #define DHD_COREDUMP_MEMPOOL_INIT(dhdp)		dhd_coredump_mempool_init(dhdp)
 #define DHD_COREDUMP_MEMPOOL_DEINIT(dhdp)	dhd_coredump_mempool_deinit(dhdp)
 #define DHD_COREDUMP_IGNORE_TRAP_SIG "host_wake_asserted_for_too_long"
 #else
 #define DHD_COREDUMP_MEMPOOL_INIT(dhdp)		do { /* noop */ } while (0)
 #define DHD_COREDUMP_MEMPOOL_DEINIT(dhdp)	do { /* noop */ } while (0)
 #endif /* DHD_COREDUMP */

 #ifdef BCMPCIE
 extern int dhd_prot_debug_info_print(dhd_pub_t *dhd);
 extern bool dhd_bus_skip_clm(dhd_pub_t *dhdp);
 extern void dhd_pcie_dump_rc_conf_space_cap(dhd_pub_t *dhd);
 extern bool dhd_pcie_dump_int_regs(dhd_pub_t *dhd);
 void dhd_prot_ctrl_info_print(dhd_pub_t *dhd);
 #else
 #define dhd_prot_debug_info_print(x)
 static INLINE bool dhd_bus_skip_clm(dhd_pub_t *dhd_pub)
 { return 0; }
 #endif /* BCMPCIE */

 #if defined(__linux__)
 void dhd_show_kirqstats(dhd_pub_t *dhd);
 #else
 static INLINE void dhd_show_kirqstats(dhd_pub_t *dhd)
 { return; }
 #endif /* defined(__linux__) */

 /* Bitmask used for Join Timeout */
 #define WLC_SSID_MASK          0x01
 #define WLC_WPA_MASK           0x02

 #if defined(__linux__) || defined(DHD_EFI)
 fw_download_status_t dhd_fw_download_status(dhd_pub_t *dhd_pub);
 extern int dhd_start_join_timer(dhd_pub_t *pub);
 extern int dhd_stop_join_timer(dhd_pub_t *pub);
 extern int dhd_start_scan_timer(dhd_pub_t *pub, bool is_escan);
 extern int dhd_stop_scan_timer(dhd_pub_t *pub, bool is_escan, uint16 sync_id);
 extern int dhd_start_cmd_timer(dhd_pub_t *pub);
 extern int dhd_stop_cmd_timer(dhd_pub_t *pub);
 extern int dhd_start_bus_timer(dhd_pub_t *pub);
 extern int dhd_stop_bus_timer(dhd_pub_t *pub);
 extern uint16 dhd_get_request_id(dhd_pub_t *pub);
 extern int dhd_set_request_id(dhd_pub_t *pub, uint16 id, uint32 cmd);
 extern void dhd_clear_join_error(dhd_pub_t *pub, uint32 mask);
 extern void dhd_get_scan_to_val(dhd_pub_t *pub, uint32 *to_val);
 extern void dhd_set_scan_to_val(dhd_pub_t *pub, uint32 to_val);
 extern void dhd_get_join_to_val(dhd_pub_t *pub, uint32 *to_val);
 extern void dhd_set_join_to_val(dhd_pub_t *pub, uint32 to_val);
 extern void dhd_get_cmd_to_val(dhd_pub_t *pub, uint32 *to_val);
 extern void dhd_set_cmd_to_val(dhd_pub_t *pub, uint32 to_val);
 extern void dhd_get_bus_to_val(dhd_pub_t *pub, uint32 *to_val);
 extern void dhd_set_bus_to_val(dhd_pub_t *pub, uint32 to_val);
 extern int dhd_start_timesync_timer(dhd_pub_t *pub);
 extern int dhd_stop_timesync_timer(dhd_pub_t *pub);
 #else
 static INLINE fw_download_status_t dhd_fw_download_status(dhd_pub_t *dhd_pub)
 { return FW_UNLOADED; }
 static INLINE int dhd_start_join_timer(dhd_pub_t *pub) { return 0; }
 static INLINE int dhd_stop_join_timer(dhd_pub_t *pub) { return 0; }
 static INLINE int dhd_start_scan_timer(dhd_pub_t *pub, bool is_escan) { return 0; }
 static INLINE int dhd_stop_scan_timer(dhd_pub_t *pub, bool is_escan, uint16 sync_id) { return 0; }
 static INLINE int dhd_start_cmd_timer(dhd_pub_t *pub) { return 0; }
 static INLINE int dhd_stop_cmd_timer(dhd_pub_t *pub) { return 0; }
 static INLINE int dhd_start_bus_timer(dhd_pub_t *pub) { return 0; }
 static INLINE int dhd_stop_bus_timer(dhd_pub_t *pub) { return 0; }
 static INLINE uint16 dhd_get_request_id(dhd_pub_t *pub) {  return 0; }
 static INLINE int dhd_set_request_id(dhd_pub_t *pub, uint16 id) {  return 0; }
 static INLINE void dhd_clear_join_error(dhd_pub_t *pub, uint32 mask) {  return; }
 static INLINE void dhd_get_scan_to_val(dhd_pub_t *pub, uint32 *to_val) {  return; }
 static INLINE void dhd_set_scan_to_val(dhd_pub_t *pub, uint32 to_val) {  return; }
 static INLINE void dhd_get_join_to_val(dhd_pub_t *pub, uint32 *to_val) {  return; }
 static INLINE void dhd_set_join_to_val(dhd_pub_t *pub, uint32 to_val) {  return; }
 static INLINE void dhd_get_cmd_to_val(dhd_pub_t *pub, uint32 *to_val) {  return; }
 static INLINE void dhd_set_cmd_to_val(dhd_pub_t *pub, uint32 to_val) {  return; }
 static INLINE void dhd_get_bus_to_val(dhd_pub_t *pub, uint32 *to_val) {  return; }
 static INLINE void dhd_set_bus_to_val(dhd_pub_t *pub, uint32 to_val) {  return; }
 static INLINE int dhd_start_timesync_timer(dhd_pub_t *pub) { return 0; }
 static INLINE int dhd_stop_timesync_timer(dhd_pub_t *pub) { return 0; }
 #endif /* defined(__linux__) */

 #ifdef DHD_PKTID_AUDIT_ENABLED
 #if defined(__linux__)
 void dhd_pktid_error_handler(dhd_pub_t *dhdp);
 #else /* !__linux__ */
 static INLINE void dhd_pktid_error_handler(dhd_pub_t *dhdp) { ASSERT(0); }
 #endif /* __linux__ */
 #endif /* DHD_PKTID_AUDIT_ENABLED */

 #ifdef DHD_MAP_PKTID_LOGGING
 #if defined(__linux__)
 extern void dhd_pktid_logging_dump(dhd_pub_t *dhdp);
 #else /* !__linux__ */
 static INLINE void dhd_pktid_logging_dump(dhd_pub_t *dhdp) { }
 #endif /* __linux__ */
 #endif /* DHD_MAP_PKTID_LOGGING */

 #ifdef DHD_PCIE_RUNTIMEPM
 #define DEFAULT_DHD_RUNTIME_MS 100
 #ifndef CUSTOM_DHD_RUNTIME_MS
 #define CUSTOM_DHD_RUNTIME_MS DEFAULT_DHD_RUNTIME_MS
 #endif /* CUSTOM_DHD_RUNTIME_MS */

 #ifndef MAX_IDLE_COUNT
 #define MAX_IDLE_COUNT 11
 #endif /* MAX_IDLE_COUNT */

 extern bool dhd_runtimepm_state(dhd_pub_t *dhd);
 extern bool dhd_runtime_bus_wake(struct dhd_bus *bus, bool wait, void *func_addr);
 extern bool dhdpcie_runtime_bus_wake(dhd_pub_t *dhdp, bool wait, void *func_addr);
 extern void dhdpcie_block_runtime_pm(dhd_pub_t *dhdp);
 extern bool dhdpcie_is_resume_done(dhd_pub_t *dhdp);
 extern void dhd_runtime_pm_disable(dhd_pub_t *dhdp);
 extern void dhd_runtime_pm_enable(dhd_pub_t *dhdp);
 #ifdef RPM_FAST_TRIGGER
 /* Requirement is 20msec, but keep it 10msec to account for any scheduling latencies */
 #define RPM_FAST_TRIGGER_THR 10
 extern uint dhd_fast_runtimepm_ms;
 extern void dhdpcie_trigger_rpm_fast(dhd_pub_t *dhdp);
 #endif /* RPM_FAST_TRIGGER */
 /* Disable the Runtime PM thread and wake up if the bus is already in suspend */
 #define DHD_DISABLE_RUNTIME_PM(dhdp) \
 do { \
 	dhd_runtime_pm_disable(dhdp); \
 } while (0);

 /* Enable the Runtime PM thread */
 #define DHD_ENABLE_RUNTIME_PM(dhdp) \
 do { \
 	dhd_runtime_pm_enable(dhdp); \
 } while (0);

 /* Stop the timer and disable RPM thread */
 #define DHD_STOP_RPM_TIMER(dhdp) \
 do { \
 	dhd_os_runtimepm_timer(dhdp, 0); \
 	DHD_DISABLE_RUNTIME_PM(dhdp) \
 } while (0);

 /* Start the timer and enable RPM thread */
 #define DHD_START_RPM_TIMER(dhdp) \
 do { \
 	dhd_os_runtimepm_timer(dhdp, dhd_runtimepm_ms); \
 	DHD_ENABLE_RUNTIME_PM(dhdp) \
 } while (0);
 #else
 #define DHD_DISABLE_RUNTIME_PM(dhdp)
 #define DHD_ENABLE_RUNTIME_PM(dhdp)
 #define DHD_STOP_RPM_TIMER(dhdp)
 #define DHD_START_RPM_TIMER(dhdp)
 #endif /* DHD_PCIE_RUNTIMEPM */

 extern bool dhd_prot_is_h2d_ring_empty(dhd_pub_t *dhd, void *prot_info);
 extern void dhd_prot_dump_ring_ptrs(void *prot_info);
 extern bool dhd_prot_check_pending_ctrl_cmpls(dhd_pub_t *dhd);

 #if defined(__linux__)
 #if defined(DHD_TRACE_WAKE_LOCK)
 void dhd_wk_lock_stats_dump(dhd_pub_t *dhdp);
 #endif
 #endif /* __linux__ */

 extern bool dhd_query_bus_erros(dhd_pub_t *dhdp);
 void dhd_clear_all_errors(dhd_pub_t *dhdp);

 #if defined(__linux__) && defined(CONFIG_64BIT)
 #define DHD_SUPPORT_64BIT
 #elif defined(DHD_EFI)
 #define DHD_SUPPORT_64BIT
 /* by default disabled for other platforms, can enable appropriate macro to enable 64 bit support */
 #endif /* __linux__ && CONFIG_64BIT */

 #if defined(DHD_EFI) || defined(DHD_ERPOM)
 extern void dhd_schedule_reset(dhd_pub_t *dhdp);
 #else
 static INLINE void dhd_schedule_reset(dhd_pub_t *dhdp) {;}
 #endif /* DHD_EFI || DHD_ERPOM */

 extern void init_dhd_timeouts(dhd_pub_t *pub);
 extern void deinit_dhd_timeouts(dhd_pub_t *pub);

 typedef enum timeout_resons {
 	DHD_REASON_COMMAND_TO,
 	DHD_REASON_JOIN_TO,
 	DHD_REASON_SCAN_TO,
 	DHD_REASON_OQS_TO
 } timeout_reasons_t;

 #ifdef REPORT_FATAL_TIMEOUTS
 void dhd_send_trap_to_fw_for_timeout(dhd_pub_t * pub, timeout_reasons_t reason);
 #endif
 #if defined(PCIE_OOB) || defined(PCIE_INB_DW)
 extern int dhd_bus_set_device_wake(struct dhd_bus *bus, bool val, const char *context);
 extern void dhd_bus_dw_deassert(dhd_pub_t *dhd, const char *context);
 #endif /* defined(PCIE_OOB) || defined(PCIE_INB_DW) */
 extern void dhd_prhex(const char *msg, volatile uchar *buf, uint nbytes, uint32 dbg_level);
 int dhd_tput_test(dhd_pub_t *dhd, tput_test_t *tput_data);
 void dhd_tput_test_rx(dhd_pub_t *dhd, void *pkt);
 #ifdef DHD_EFI
 int dhd_get_max_txbufs(dhd_pub_t *dhdp);
 #else
 static INLINE int dhd_get_max_txbufs(dhd_pub_t *dhdp)
 { return -1; }
 #endif

 #ifdef FILTER_IE
 int dhd_read_from_file(dhd_pub_t *dhd);
 int dhd_parse_filter_ie(dhd_pub_t *dhd, uint8 *buf);
 int dhd_get_filter_ie_count(dhd_pub_t *dhd, uint8 *buf);
 int dhd_parse_oui(dhd_pub_t *dhd, uint8 *inbuf, uint8 *oui, int len);
 int dhd_check_valid_ie(dhd_pub_t *dhdp, uint8 *buf, int len);
 #endif /* FILTER_IE */

 uint16 dhd_prot_get_ioctl_trans_id(dhd_pub_t *dhdp);

 #ifdef SET_PCIE_IRQ_CPU_CORE
 enum {
 	DHD_AFFINITY_OFF = 0,
 	DHD_AFFINITY_TPUT_150MBPS,
 	DHD_AFFINITY_TPUT_300MBPS,
 	DHD_AFFINITY_LAST
 };

 extern void dhd_set_irq_cpucore(dhd_pub_t *dhdp, int affinity_cmd);
 #endif /* SET_PCIE_IRQ_CPU_CORE */
 #if defined(DHD_HANG_SEND_UP_TEST)
 extern void dhd_make_hang_with_reason(struct net_device *dev, const char *string_num);
 #endif /* DHD_HANG_SEND_UP_TEST */
 #ifdef BTLOG
 extern void dhd_rx_bt_log(dhd_pub_t *dhdp, void *pkt);
 #endif	/* BTLOG */

 #ifdef DHD_RND_DEBUG
 int dhd_dump_rnd_info(dhd_pub_t *dhd, uint8 *rnd_buf, uint32 rnd_len);
 int dhd_get_rnd_info(dhd_pub_t *dhd);
 #endif /* DHD_RND_DEBUG */

 #ifdef DHD_WAKE_STATUS
 wake_counts_t* dhd_get_wakecount(dhd_pub_t *dhdp);
 #endif /* DHD_WAKE_STATUS */
 extern int dhd_get_random_bytes(uint8 *buf, uint len);

 #if defined(DHD_BLOB_EXISTENCE_CHECK)
 extern void dhd_set_blob_support(dhd_pub_t *dhdp, char *fw_path);
 #endif /* DHD_BLOB_EXISTENCE_CHECK */

 int dhd_get_preserve_log_numbers(dhd_pub_t *dhd, uint64 *logset_mask);
 #define DHD_WORD_TO_LEN_SHIFT		(2u)       /* WORD to BYTES SHIFT */

 #if defined(__linux__) || defined(DHD_EFI)
 int dhd_export_debug_data(void *mem_buf, void *fp, const void *user_buf, uint32 buf_len, void *pos);
 #else
 static int dhd_export_debug_data(void *mem_buf, void *fp, const void *user_buf,
 	uint32 buf_len, void *pos)
 { return 0; }
 #endif /* __linux__ */
 #if defined(__linux__)
 #define DHD_PCIE_CONFIG_SAVE(bus)	pci_save_state(bus->dev)
 #define DHD_PCIE_CONFIG_RESTORE(bus)	pci_restore_state(bus->dev)
 #elif defined(DHD_EFI) || defined(NDIS)
 /* For EFI the pcie config space which is saved during init
 * is the one that should always be restored, so NOP for save
 */
 #define DHD_PCIE_CONFIG_SAVE(bus)
 #define DHD_PCIE_CONFIG_RESTORE(bus)	dhdpcie_config_restore(bus, TRUE)
 #else
 #define DHD_PCIE_CONFIG_SAVE(bus)	do { /* noop */ } while (0)
 #define DHD_PCIE_CONFIG_RESTORE(bus)	do { /* noop */ } while (0)
 #endif /* __linux__ */

 typedef struct dhd_pkt_parse {
 	uint32 proto;	/* Network layer protocol */
 	uint32 t1;	/* n-tuple */
 	uint32 t2;
 } dhd_pkt_parse_t;

 /* ========= RING API functions : exposed to others ============= */
 #define DHD_RING_TYPE_FIXED		1
 #define DHD_RING_TYPE_SINGLE_IDX	2
 uint32 dhd_ring_get_hdr_size(void);
 void *dhd_ring_init(dhd_pub_t *dhdp, uint8 *buf, uint32 buf_size, uint32 elem_size,
 	uint32 elem_cnt, uint32 type);
 void dhd_ring_deinit(dhd_pub_t *dhdp, void *_ring);
 void *dhd_ring_get_first(void *_ring);
 void dhd_ring_free_first(void *_ring);
 void dhd_ring_set_read_idx(void *_ring, uint32 read_idx);
 void dhd_ring_set_write_idx(void *_ring, uint32 write_idx);
 uint32 dhd_ring_get_read_idx(void *_ring);
 uint32 dhd_ring_get_write_idx(void *_ring);
 void *dhd_ring_get_last(void *_ring);
 void *dhd_ring_get_next(void *_ring, void *cur);
 void *dhd_ring_get_prev(void *_ring, void *cur);
 void *dhd_ring_get_empty(void *_ring);
 int dhd_ring_get_cur_size(void *_ring);
 void dhd_ring_lock(void *ring, void *fist_ptr, void *last_ptr);
 void dhd_ring_lock_free(void *ring);
 void *dhd_ring_lock_get_first(void *_ring);
 void *dhd_ring_lock_get_last(void *_ring);
 int dhd_ring_lock_get_count(void *_ring);
 void dhd_ring_lock_free_first(void *ring);
 void dhd_ring_whole_lock(void *ring);
 void dhd_ring_whole_unlock(void *ring);

 #ifdef GDB_PROXY
 /** Firmware loaded and GDB proxy may access memory and registers */
 #define DHD_GDB_PROXY_PROBE_ACCESS_ENABLED		0x00000001
 /** Firmware loaded, access to it is enabled but it is not running yet */
 #define DHD_GDB_PROXY_PROBE_FIRMWARE_NOT_RUNNING	0x00000002
 /** Firmware is running */
 #define DHD_GDB_PROXY_PROBE_FIRMWARE_RUNNING		0x00000004
 /** Firmware was started in bootloader mode */
 #define DHD_GDB_PROXY_PROBE_BOOTLOADER_MODE		0x00000008
 /** Host memory code offload present */
 #define DHD_GDB_PROXY_PROBE_HOSTMEM_CODE		0x00000010
 /** Memory dump count field present */
 #define DHD_GDB_PROXY_PROBE_MEMDUMP_COUNT		0x00000020

 /* Data structure, returned by "gdb_proxy_probe" iovar */
 typedef struct dhd_gdb_proxy_probe_data {
 	uint32 data_len;		/* Length of data in structure */
 	uint32 magic;			/* Must contain DHD_IOCTL_MAGIC */
 	uint32 flags;			/* Set of DHD_GDB_PROXY_PROBE_... bits */
 	uint32 last_id;			/* 0 or proxy ID last set */
 	uint32 hostmem_code_win_base;	/* Hostmem code window start in ARM physical address space
 					 */
 	uint32 hostmem_code_win_length;	/* Hostmem code window length */
 	uint32 mem_dump_count;		/* Number of memory dumps made so far */
 } dhd_gdb_proxy_probe_data_t;

 /* Timeout loop brackets */
 /* Intended usage is to keep repeating timeoutable operation (operation that expected to
  * succeed but may fail because of timeout) while timeout may be explained by firmware
  * stop in gdb
  * Example:
  *	dhd_pub_t *dhd;
  *	...
  *	#ifdef GDB_PROXY
  *	GDB_PROXY_TIMEOUT_DO(dhd) {
  *		operation_that_may_succeed_or_timeout();
  *	} GDB_PROXY_TIMEOUT_WHILE(operation_timed_out());
  *	#else
  *	operation_that_may_succeed_or_timeout();
  *	#endif
  *	...
  *	if (operation_timed_out()) {
  *		bang_memdump_crash_horror();
  *	}
  */
 /* Argument is pointer to dhd_pub_t structure */
 #define GDB_PROXY_TIMEOUT_DO(dhd)				\
 {								\
 	uint32 gdb_prev_stop_count;				\
 	dhd_pub_t *gdb_dhd = dhd;				\
 	do {							\
 		gdb_prev_stop_count = gdb_dhd->gdb_proxy_stop_count;

 /* Argument should evaluate to true if operation failed because of timeout */
 #define GDB_PROXY_TIMEOUT_WHILE(timeout_cond)							\
 	} while ((timeout_cond) && ((gdb_dhd->gdb_proxy_stop_count != gdb_prev_stop_count) ||	\
 				(gdb_dhd->gdb_proxy_stop_count & GDB_PROXY_STOP_MASK)));	\
 }
 #endif /* GDB_PROXY */


 #ifdef DHD_EFI
 extern void dhd_insert_random_mac_addr(dhd_pub_t *dhd, char *nvram_mem, uint *len);
 #endif /* DHD_EFI */

 #ifdef PKT_FILTER_SUPPORT
 extern void dhd_pktfilter_offload_set(dhd_pub_t * dhd, char *arg);
 extern void dhd_pktfilter_offload_enable(dhd_pub_t * dhd, char *arg, int enable, int master_mode);
 extern void dhd_pktfilter_offload_delete(dhd_pub_t *dhd, int id);
 #endif

 #ifdef DHD_DUMP_PCIE_RINGS
 extern int dhd_d2h_h2d_ring_dump(dhd_pub_t *dhd, void *file, const void *user_buf,
 	unsigned long *file_posn, bool file_write);
 #endif /* DHD_DUMP_PCIE_RINGS */

 #ifdef EWP_EDL
 #define DHD_EDL_RING_SIZE (D2HRING_EDL_MAX_ITEM * D2HRING_EDL_ITEMSIZE)
 int dhd_event_logtrace_process_edl(dhd_pub_t *dhdp, uint8 *data,
 		void *evt_decode_data);
 int dhd_edl_mem_init(dhd_pub_t *dhd);
 void dhd_edl_mem_deinit(dhd_pub_t *dhd);
 void dhd_prot_edl_ring_tcm_rd_update(dhd_pub_t *dhd);
 #define DHD_EDL_MEM_INIT(dhdp) dhd_edl_mem_init(dhdp)
 #define DHD_EDL_MEM_DEINIT(dhdp) dhd_edl_mem_deinit(dhdp)
 #define DHD_EDL_RING_TCM_RD_UPDATE(dhdp) \
 	dhd_prot_edl_ring_tcm_rd_update(dhdp)
 #else
 #define DHD_EDL_MEM_INIT(dhdp) do { /* noop */ } while (0)
 #define DHD_EDL_MEM_DEINIT(dhdp) do { /* noop */ } while (0)
 #define DHD_EDL_RING_TCM_RD_UPDATE(dhdp) do { /* noop */ } while (0)
 #endif /* EWP_EDL */


 #if defined(DHD_H2D_LOG_TIME_SYNC)
 void dhd_h2d_log_time_sync_deferred_wq_schedule(dhd_pub_t *dhdp);
 void dhd_h2d_log_time_sync(dhd_pub_t *dhdp);
 #endif /* DHD_H2D_LOG_TIME_SYNC */
 extern void dhd_cleanup_if(struct net_device *net);

 void dhd_schedule_logtrace(void *dhd_info);
 int dhd_print_fw_ver_from_file(dhd_pub_t *dhdp, char *fwpath);

 #if defined(__linux__)
 /* configuration of ecounters. API's tp start/stop. currently supported only for linux */
 extern int dhd_ecounter_configure(dhd_pub_t *dhd, bool enable);
 extern int dhd_start_ecounters(dhd_pub_t *dhd);
 extern int dhd_stop_ecounters(dhd_pub_t *dhd);
 extern int dhd_start_event_ecounters(dhd_pub_t *dhd);
 extern int dhd_stop_event_ecounters(dhd_pub_t *dhd);
 #endif /* __linux__ */

 #define DHD_DUMP_TYPE_NAME_SIZE		32
 #define DHD_DUMP_FILE_PATH_SIZE		256
 #define DHD_DUMP_FILE_COUNT_MAX		5
 #define DHD_DUMP_TYPE_COUNT_MAX		10

 #ifdef DHD_DUMP_MNGR
 typedef struct _DFM_elem {
 	char type_name[DHD_DUMP_TYPE_NAME_SIZE];
 	char file_path[DHD_DUMP_FILE_COUNT_MAX][DHD_DUMP_FILE_PATH_SIZE];
 	int file_idx;
 } DFM_elem_t;

 typedef struct _dhd_dump_file_manage {
 	DFM_elem_t elems[DHD_DUMP_TYPE_COUNT_MAX];
 } dhd_dump_file_manage_t;

 extern void dhd_dump_file_manage_enqueue(dhd_pub_t *dhd, char *dump_path, char *fname);
 #endif /* DHD_DUMP_MNGR */

 #define HD_PREFIX_SIZE  2   /* hexadecimal prefix size */
 #define HD_BYTE_SIZE    2   /* hexadecimal byte size */

 #ifdef DHD_HP2P
 extern unsigned long dhd_os_hp2plock(dhd_pub_t *pub);
 extern void dhd_os_hp2punlock(dhd_pub_t *pub, unsigned long flags);
 #endif /* DHD_HP2P */

 #ifdef DNGL_AXI_ERROR_LOGGING
 extern void dhd_axi_error(dhd_pub_t *dhd);
 #ifdef DHD_USE_WQ_FOR_DNGL_AXI_ERROR
 extern void dhd_axi_error_dispatch(dhd_pub_t *dhdp);
 #endif /* DHD_USE_WQ_FOR_DNGL_AXI_ERROR */
 #endif /* DNGL_AXI_ERROR_LOGGING */

 #ifdef DHD_STATUS_LOGGING
 #include <dhd_statlog.h>
 #else
 #define ST(x)		0
 #define STDIR(x)	0
 #define DHD_STATLOG_CTRL(dhdp, stat, ifidx, reason) \
 	do { /* noop */ } while (0)
 #define DHD_STATLOG_DATA(dhdp, stat, ifidx, dir, cond) \
 	do { BCM_REFERENCE(cond); } while (0)
 #define DHD_STATLOG_DATA_RSN(dhdp, stat, ifidx, dir, reason) \
 	do { /* noop */ } while (0)
 #endif /* DHD_STATUS_LOGGING */

 #ifdef SUPPORT_SET_TID
 enum dhd_set_tid_mode {
 	/* Disalbe changing TID */
 	SET_TID_OFF = 0,
 	/* Change TID for all UDP frames */
 	SET_TID_ALL_UDP,
 	/* Change TID for UDP frames based on UID */
 	SET_TID_BASED_ON_UID
 };

 #define DEFAULT_SET_TID_TARGET_UID	0
 #define DEFAULT_SET_TID_TARGET_PRIO	0
 #if defined(__linux__)
 extern void dhd_set_tid_based_on_uid(dhd_pub_t *dhdp, void *pkt);
 #else
 static INLINE void dhd_set_tid_based_on_uid(dhd_pub_t *dhdp, void *pkt) { return; }
 #endif /* __linux__ */
 #endif /* SUPPORT_SET_TID */

 #ifdef CONFIG_SILENT_ROAM
 extern int dhd_sroam_set_mon(dhd_pub_t *dhd, bool set);
 typedef wlc_sroam_info_v1_t wlc_sroam_info_t;
 #endif /* CONFIG_SILENT_ROAM */

 #ifdef DHD_DUMP_FILE_WRITE_FROM_KERNEL
 #define FILE_NAME_HAL_TAG	""
 #else
 #define FILE_NAME_HAL_TAG	"_hal" /* The tag name concatenated by HAL */
 #endif /* DHD_DUMP_FILE_WRITE_FROM_KERNEL */

 extern bool dhd_cancel_work_sync(void *work);
 extern bool dhd_cancel_delayed_work_sync(void *dwork);
 extern bool dhd_cancel_delayed_work(void *dwork);

 void dhd_bus_counters(dhd_pub_t *dhdp, struct bcmstrbuf *strbuf);

 #define DHD_HISTOGRAM_ENTRIES	(14u)
 #define DHD_HISTOGRAM_SIZE	(sizeof(uint64) * DHD_HISTOGRAM_ENTRIES)

 void dhd_histo_update(dhd_pub_t *dhd, uint64 *histo, uint32 value);
 void dhd_histo_clear(dhd_pub_t *dhd, uint64 *histo);
 void dhd_histo_tag_dump(dhd_pub_t *dhd, struct bcmstrbuf *strbuf, char *tagname);
 void dhd_histo_dump(dhd_pub_t *dhd, struct bcmstrbuf *strbuf, uint64 *histo, char *histoname);
 uint64 *dhd_histo_init(dhd_pub_t *dhd);
 void dhd_histo_deinit(dhd_pub_t *dhd, uint64 *histo);

 /* Given a number 'n' returns 'm' that is next larger power of 2 after n */
 static inline uint32 next_larger_power2(uint32 num)
 {
 	if (num) {
 		num--;
 		num |= (num >> 1);
 		num |= (num >> 2);
 		num |= (num >> 4);
 		num |= (num >> 8);
 		num |= (num >> 16);
 	}
 	return (num + 1);
 }

 extern struct dhd_if * dhd_get_ifp(dhd_pub_t *dhdp, uint32 ifidx);
 void *dhd_get_roam_evt(dhd_pub_t *dhdp);
 uint8 dhd_d11_slices_num_get(dhd_pub_t *dhdp);
 #if defined(DISABLE_HE_ENAB) || defined(CUSTOM_CONTROL_HE_ENAB)
 extern int dhd_control_he_enab(dhd_pub_t * dhd, uint8 he_enab);
 extern uint8 control_he_enab;
 #endif /* DISABLE_HE_ENAB  || CUSTOM_CONTROL_HE_ENAB */

 #ifdef WL_AUTO_QOS
 extern void dhd_wl_sock_qos_set_status(dhd_pub_t *dhdp, unsigned long on_off);
 #endif /* WL_AUTO_QOS */

 #ifdef DHD_TX_PROFILE
 /* whether or not a dhd_tx_profile_protocol_t matches with data in a packet */
 bool dhd_protocol_matches_profile(uint8 *p, int plen,
         const dhd_tx_profile_protocol_t *proto, bool is_host_sfhllc);
 int dhd_tx_profile_attach(dhd_pub_t *dhdp);
 int dhd_tx_profile_detach(dhd_pub_t *dhdp);
 #endif /* defined (DHD_TX_PROFILE) */
 #if defined(DHD_LB_RXP)
 uint32 dhd_lb_rxp_process_qlen(dhd_pub_t *dhdp);
 /*
  * To avoid OOM, Flow control will be kicked in when packet size in process_queue
  * crosses LB_RXP_STOP_THR * rcpl ring size * 1500(pkt size) and will stop
  * when it goes below LB_RXP_STRT_THR * rcpl ring size * 1500(pkt size)
  * By default flow control is diabled. i.e tunables set to 0/0.
  * to enable flow control, these tunables need to be passed from platform Makefiles.
  */
 #ifndef LB_RXP_STOP_THR
 #define LB_RXP_STOP_THR 0
 #endif /* LB_RXP_STOP_THR */
 #ifndef LB_RXP_STRT_THR
 #define LB_RXP_STRT_THR 0
 #endif /* LB_RXP_STRT_THR */

 #endif /* DHD_LB_RXP */
 #ifdef DHD_SUPPORT_HDM
 extern bool hdm_trigger_init;
 extern int dhd_module_init_hdm(void);
 extern void dhd_hdm_wlan_sysfs_init(void);
 extern void dhd_hdm_wlan_sysfs_deinit(struct work_struct *);
 extern int hdm_wifi_support;
 #define SYSFS_DEINIT_MS 10
 #endif /* DHD_SUPPORT_HDM */

 #if defined(__linux__)
 #if LINUX_VERSION_CODE >= KERNEL_VERSION(4, 19, 0) && defined(DHD_TCP_LIMIT_OUTPUT)
 extern void dhd_ctrl_tcp_limit_output_bytes(int level);
 #endif /* LINUX_VERSION_CODE > 4.19.0 && DHD_TCP_LIMIT_OUTPUT */
 extern void dhd_schedule_delayed_dpc_on_dpc_cpu(dhd_pub_t *dhdp, ulong delay);
 extern void dhd_handle_pktdata(dhd_pub_t *dhdp, int ifidx, void *pkt, uint8 *pktdata,
 	uint32 pktid, uint32 pktlen, uint16 *pktfate, uint8 *dhd_udr, uint8 *dhd_igmp,
 	bool tx, int pkt_wake, bool pkt_log);
 #else
 static INLINE void dhd_schedule_delayed_dpc_on_dpc_cpu(dhd_pub_t *dhdp, ulong delay)
 	{ return; }
 static INLINE void dhd_handle_pktdata(dhd_pub_t *dhdp, int ifidx, void *pkt, uint8 *pktdata,
 	uint32 pktid, uint32 pktlen, uint16 *pktfate, uint8 *dhd_udr, uint8 *dhd_igmp,
 	bool tx, int pkt_wake, bool pkt_log) { return; }
 #endif /* __linux */
 #if defined(WLAN_ACCEL_BOOT)
 extern int dhd_dev_set_accel_force_reg_on(struct net_device *dev);
 extern int dhd_dev_clear_accel_force_reg_on(struct net_device *dev);
 #endif /* WLAN_ACCEL_BOOT */

 #if defined(BCMPCIE) && defined(__linux__)
 extern int dhd_check_shinfo_nrfrags(dhd_pub_t *dhdp, void *pktbuf, dmaaddr_t *pa, uint32 pktid);
 #else
 static INLINE int dhd_check_shinfo_nrfrags(dhd_pub_t *dhdp, void *pktbuf, dmaaddr_t *pa,
 	uint32 pktid) { return BCME_OK; }
 #endif /* BCMPCIE && __linux__ */

 #ifdef HOST_SFH_LLC
 int dhd_ether_to_8023_hdr(osl_t *osh, struct ether_header *eh, void *p);
 int dhd_8023_llc_to_ether_hdr(osl_t *osh, struct ether_header *eh8023, void *p);
 #endif


 int dhd_ether_to_generic_llc_hdr(struct dhd_pub *dhd, uint8 ifidx,
 	struct ether_header *eh, void *p);
 int dhd_generic_llc_to_eth_hdr(struct dhd_pub *dhd, uint8 ifidx, struct ether_header *eh, void *p);
 bool dhd_llc_hdr_insert_enabled(struct dhd_pub *dhd, uint8 ifidx);
 void dhd_update_ifp_headroom_len(struct dhd_pub *dhdp, struct dhd_if *ifp);

 #ifdef CUSTOMER_HW4_DEBUG
 bool dhd_validate_chipid(dhd_pub_t *dhdp);
 #endif /* CUSTOMER_HW4_DEBUG */

 #ifdef RX_PKT_POOL
 #define MAX_RX_PKT_POOL	(1024)
 void dhd_rx_pktpool_create(struct dhd_info *dhd, uint16 len);
 void * BCMFASTPATH(dhd_rxpool_pktget)(osl_t *osh, struct dhd_info *dhd, uint16 len);
 #endif /* RX_PKT_POOL */

 int dhd_rxf_thread(void *data);
 void dhd_sched_rxf(dhd_pub_t *dhdp, void *skb);
 int dhd_os_wake_lock_rx_timeout_enable(dhd_pub_t *pub, int val);

 #if defined(__linux__)

 #ifdef DHD_SUPPORT_VFS_CALL

 #if (LINUX_VERSION_CODE < KERNEL_VERSION(3, 19, 0))
 #define DHD_VFS_INODE(dir) (dir->d_inode)
 #else
 #define DHD_VFS_INODE(dir) d_inode(dir)
 #endif /* LINUX_VERSION_CODE < KERNEL_VERSION(3, 19, 0) */

 #if (LINUX_VERSION_CODE < KERNEL_VERSION(3, 13, 0))
 #define DHD_VFS_UNLINK(dir, b, c) vfs_unlink(DHD_VFS_INODE(dir), b)
 #elif (LINUX_VERSION_CODE < KERNEL_VERSION(5, 12, 0))
 #define DHD_VFS_UNLINK(dir, b, c) vfs_unlink(DHD_VFS_INODE(dir), b, c)
 #else
 #define DHD_VFS_UNLINK(dir, b, c) vfs_unlink(&init_user_ns, DHD_VFS_INODE(dir), b, c)
 #endif /* LINUX_VERSION_CODE < KERNEL_VERSION(3, 13, 0) */
 static INLINE struct file *dhd_filp_open(const char *filename, int flags, int mode)
 {
 	return filp_open(filename, flags, mode);
 }

 static INLINE int dhd_filp_close(void *image, void *id)
 {
 	return filp_close((struct file *)image, id);
 }

 static INLINE int dhd_i_size_read(const struct inode *inode)
 {
 	return i_size_read(inode);
 }

 static INLINE int dhd_kernel_read_compat(struct file *fp, loff_t pos, void *buf, size_t count)
 {
 	return kernel_read_compat(fp, pos, buf, count);
 }

 static INLINE int dhd_vfs_read(struct file *filep, char *buf, size_t size, loff_t *pos)
 {
 	return vfs_read(filep, buf, size, pos);
 }

 static INLINE int dhd_vfs_write(struct file *filep, char *buf, size_t size, loff_t *pos)
 {
 	return vfs_write(filep, buf, size, pos);
 }

 static INLINE int dhd_vfs_fsync(struct file *filep, int datasync)
 {
 	return vfs_fsync(filep, datasync);
 }

 static INLINE int dhd_vfs_stat(char *filepath, struct kstat *stat)
 {
 #if (LINUX_VERSION_CODE >= KERNEL_VERSION(5, 10, 0))
 	struct path path;
 	int error;
 	error = kern_path(filepath, LOOKUP_FOLLOW, &path);
 	if (error) {
 		return error;
 	}
 	error = vfs_getattr(&path, stat, STATX_TYPE, AT_STATX_SYNC_AS_STAT);
 	path_put(&path);
 	if (error) {
 		return error;
 	}

 	return error;
 #else
 	return vfs_stat(filepath, stat);
 #endif /* LINUX_VERSION_CODE < KERNEL_VERSION(5, 10, 0) */
 }

 static INLINE int dhd_kern_path(char *name, int flags, struct path *file_path)
 {
 	return kern_path(name, flags, file_path);
 }
 #endif /* DHD_SUPPORT_VFS_CALL */

 #ifndef DHD_SUPPORT_VFS_CALL
 #define DHD_VFS_UNLINK(dir, b, c) 0

 static INLINE struct file *dhd_filp_open(const char *filename, int flags, int mode)
 	{ return NULL; }
 static INLINE int dhd_filp_close(void *image, void *id)
 	{ return 0; }
 static INLINE int dhd_i_size_read(const struct inode *inode)
 	{ return 0; }
 static INLINE int dhd_kernel_read_compat(struct file *fp, loff_t pos, void *buf, size_t count)
 	{ return 0; }
 static INLINE int dhd_vfs_read(struct file *filep, char *buf, size_t size, loff_t *pos)
 	{ return 0; }
 static INLINE int dhd_vfs_write(struct file *filep, char *buf, size_t size, loff_t *pos)
 	{ return 0; }
 static INLINE int dhd_vfs_fsync(struct file *filep, int datasync)
 	{ return 0; }
 static INLINE int dhd_vfs_stat(char *buf, struct kstat *stat)
 	{ return 0; }
 static INLINE int dhd_kern_path(char *name, int flags, struct path *file_path)
 	{ return 0; }
 #endif /* !DHD_SUPPORT_VFS_CALL */
 #endif /* __linux__ */
 #ifdef WL_TWT
 extern int dhd_config_twt_event_mask_in_suspend(dhd_pub_t *dhdp, bool suspend);
 extern int dhd_send_twt_info_suspend(dhd_pub_t *dhdp, bool suspend);
 #endif /* WL_TWT */
 #if defined(DHD_WAKE_STATUS_PRINT) && defined(DHD_WAKE_RX_STATUS) && defined(DHD_WAKE_STATUS)
 void dhd_dump_wake_status(dhd_pub_t *dhdp, wake_counts_t *wcp, struct ether_header *eh);
 #endif /* DHD_WAKE_STATUS_PRINT && DHD_WAKE_RX_STATUS && DHD_WAKE_STATUS */
 #ifdef SUPPORT_OTA_UPDATE
 void dhd_ota_buf_clean(dhd_pub_t *dhdp);
 #endif /* SUPPORT_OTA_UPDATE */

 #if defined(DHD_DEBUGABILITY_LOG_DUMP_RING) || defined (DHD_DEBUGABILITY_EVENT_RING)
 #ifndef DEBUGABILITY
 #error "DHD_DEBUGABILITY_LOG_DUMP_RING or DHD_DEBUGABILITY_EVENT_RING without DEBUGABILITY"
 #endif /* DEBUGABILITY */
 #endif /* defined(DHD_DEBUGABILITY_LOG_DUMP_RING) || defined(DHD_DEBUGABILITY_EVENT_RING) */
 #ifdef WL_CFGVENDOR_SEND_ALERT_EVENT
 typedef enum dhd_alert_reason_codes {
 	ALERT_BCN_LOST = 0,
 	ALERT_TX_STALL = 1,
 	ALERT_RX_STALL = 2,
 	ALERT_IOCTL_TIMEOUT = 3,
 	ALERT_DONGLE_TRAP = 4,
 	ALERT_SCAN_STALL = 5,
 	ALERT_SCAN_ERR = 6,
 	ALERT_SCAN_BUSY = 7,
 	ALERT_FW_QUEUE_STALL = 8
 } dhd_alert_reason_codes_t;
 int dhd_os_send_alert_message(dhd_pub_t *dhdp);
 #endif /* WL_CFGVENDOR_SEND_ALERT_EVENT */
 int dhd_schedule_socram_dump(dhd_pub_t *dhdp);

 #define IS_HWADDR_INVALID(x) \
 	(!(x) || ((x) == (uint32)-1))
 #define IS_BUFSIZE_INVALID(size, max) \
 	(!(size) || ((size) > (max)))

 #ifdef RX_CSO
 void dhd_rx_set_csum_status(dhd_pub_t *dhdp, void *pktbuf, uint16 msg_flags);
 #ifdef RX_CSO_TEST
 void dhd_rxcso_test_inject_bad_txcsum(dhd_pub_t *dhd, void *pktbuf,
 	int badcsum_type);
 #endif /* RX_CSO_TEST */
 #else
 static INLINE void dhd_rx_set_csum_status(dhd_pub_t *dhdp, void *pktbuf, uint16 msg_flags)
 	{ return; }
 #endif /* RX_CSO */

 #ifdef DHD_AGGR_WI
 #ifndef DHD_AGGR_WI_EN
 #define	DHD_AGGR_WI_EN 0u
 #endif /* DHD_AGGR_WI_EN */
 #define DHD_AGGR_WI_ENAB_MASK 0xF
 #endif /* DHD_AGGR_WI */

 #define EWP_ETB_DAP_TMC_FLUSH_CCREV 74u
 #ifdef DHD_CUSTOM_CONFIG_RTS_IN_SUSPEND
 #ifndef CUSTOM_RETRUN_TO_SLEEP_TIME_SUSPEND
 #define CUSTOM_RETRUN_TO_SLEEP_TIME_SUSPEND 20
 #endif
 #ifndef CUSTOM_RETRUN_TO_SLEEP_TIME_DEFAULT
 #define CUSTOM_RETRUN_TO_SLEEP_TIME_DEFAULT 200
 #endif
 int dhd_config_rts_in_suspend(dhd_pub_t *dhdp, bool suspend);
 #endif /* DHD_CUSTOM_CONFIG_RTS_IN_SUSPEND */

 extern void *dhd_irq_to_desc(unsigned int irq);
 extern void dhd_unregister_net(struct net_device *net, bool need_rtnl_lock);
 extern int dhd_register_net(struct net_device *net, bool need_rtnl_lock);

 #ifdef TX_FLOW_RING_INDICES_TRACE
 uint32 dhd_prot_get_flow_ring_trace_len(dhd_pub_t *dhdp);
 void dhd_prot_tx_flow_ring_trace_dump(dhd_pub_t *dhdp, struct bcmstrbuf *strbuf);
 #endif /* TX_FLOW_RING_INDICES_TRACE */

 #if defined(__linux__)
 int dhd_get_reboot_status(struct dhd_pub *dhdp);
 int dhd_get_module_exit_status(struct dhd_pub *dhdp);
 #else
 static INLINE int dhd_get_reboot_status(struct dhd_pub *dhdp) { return 0; }
 static INLINE int dhd_get_module_exit_status(struct dhd_pub *dhdp) { return 0; }
 #endif /* __linux__ */

 #if defined(WBRC) && defined(BT_FW_DWNLD)
 int dhd_bt_fw_dwnld_blob(void *wl_hdl, char* buf, size_t len);
 #endif

 #ifdef DHD_SDTC_ETB_DUMP
 extern void dhd_etb_dump_deinit(dhd_pub_t *dhd);
 #endif /* DHD_SDTC_ETB_DUMP */
 int write_dump_to_file(dhd_pub_t *dhd, uint8 *buf, int size, char *fname);
 #ifdef SHOW_LOGTRACE
 int dhd_reinit_logtrace_process(void *dhd_info);
 #endif /* SHOW_LOGTRACE */
 #ifdef DHD_VALIDATE_PKT_ADDRESS
 extern void *dhd_validate_packet_address(dhd_pub_t *dhd, void *pkt);
 extern void dhd_enqueue_inv_address_queue(struct dhd_pub *dhdp, void *pkt);
 #endif /* DHD_VALIDATE_PKT_ADDRESS */
 #endif /* _dhd_h_ */