blob: d706a6539dd091f0ad928d3002cf3f63a646c4cb [file] [log] [blame]
/*
* Copyright (c) 2014-2016 The Linux Foundation. All rights reserved.
*
* Previously licensed under the ISC license by Qualcomm Atheros, Inc.
*
*
* Permission to use, copy, modify, and/or distribute this software for
* any purpose with or without fee is hereby granted, provided that the
* above copyright notice and this permission notice appear in all
* copies.
*
* THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL
* WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED
* WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE
* AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL
* DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR
* PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
* TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
* PERFORMANCE OF THIS SOFTWARE.
*/
/*
* This file was originally distributed by Qualcomm Atheros, Inc.
* under proprietary terms before Copyright ownership was assigned
* to the Linux Foundation.
*/
/**
* DOC: qdf_types.h
* QCA driver framework (QDF) basic type definitions
*/
#if !defined(__QDF_TYPES_H)
#define __QDF_TYPES_H
/* Include Files */
#include <i_qdf_types.h>
/* Preprocessor definitions and constants */
#define QDF_MAX_SGLIST 4
/**
* struct qdf_sglist - scatter-gather list
* @nsegs: total number of segments
* struct __sg_segs - scatter-gather segment list
* @vaddr: Virtual address of the segment
* @len: Length of the segment
*/
typedef struct qdf_sglist {
uint32_t nsegs;
struct __sg_segs {
uint8_t *vaddr;
uint32_t len;
} sg_segs[QDF_MAX_SGLIST];
} qdf_sglist_t;
#define QDF_MAX_SCATTER __QDF_MAX_SCATTER
/**
* QDF_SWAP_U16 - swap input u16 value
* @_x: variable to swap
*/
#define QDF_SWAP_U16(_x) \
((((_x) << 8) & 0xFF00) | (((_x) >> 8) & 0x00FF))
/**
* QDF_SWAP_U32 - swap input u32 value
* @_x: variable to swap
*/
#define QDF_SWAP_U32(_x) \
(((((_x) << 24) & 0xFF000000) | (((_x) >> 24) & 0x000000FF)) | \
((((_x) << 8) & 0x00FF0000) | (((_x) >> 8) & 0x0000FF00)))
/* ticks per second */
#define QDF_TICKS_PER_SECOND (1000)
/**
* QDF_ARRAY_SIZE - get array size
* @_arr: array variable name
*/
#define QDF_ARRAY_SIZE(_arr) (sizeof(_arr) / sizeof((_arr)[0]))
#define QDF_MAX_SCATTER __QDF_MAX_SCATTER
/**
* qdf_packed - denotes structure is packed.
*/
#define qdf_packed __qdf_packed
typedef void *qdf_net_handle_t;
typedef void *qdf_netlink_handle_t;
typedef void *qdf_drv_handle_t;
typedef void *qdf_os_handle_t;
typedef void *qdf_pm_t;
/**
* typedef qdf_handle_t - handles opaque to each other
*/
typedef void *qdf_handle_t;
/**
* typedef qdf_device_t - Platform/bus generic handle.
* Used for bus specific functions.
*/
typedef __qdf_device_t qdf_device_t;
/**
* typedef qdf_size_t - size of an object
*/
typedef __qdf_size_t qdf_size_t;
/**
* typedef __qdf_off_t - offset for API's that need them.
*/
typedef __qdf_off_t qdf_off_t;
/**
* typedef qdf_dma_map_t - DMA mapping object.
*/
typedef __qdf_dma_map_t qdf_dma_map_t;
/**
* tyepdef qdf_dma_addr_t - DMA address.
*/
typedef __qdf_dma_addr_t qdf_dma_addr_t;
/**
* typedef __qdf_dma_size_t - DMA size.
*/
typedef __qdf_dma_size_t qdf_dma_size_t;
/**
* tyepdef qdf_dma_context_t - DMA context.
*/
typedef __qdf_dma_context_t qdf_dma_context_t;
/**
* struct qdf_dma_map_info - Information inside a DMA map.
* @nsegs: total number mapped segments
* struct __dma_segs - Information of physical address.
* @paddr: physical(dam'able) address of the segment
* @len: length of the segment
*/
typedef struct qdf_dma_map_info {
uint32_t nsegs;
struct __dma_segs {
qdf_dma_addr_t paddr;
qdf_dma_size_t len;
} dma_segs[QDF_MAX_SCATTER];
} qdf_dmamap_info_t;
#define qdf_iomem_t __qdf_iomem_t;
/**
* typedef enum QDF_TIMER_TYPE - QDF timer type
* @QDF_TIMER_TYPE_SW: Deferrable SW timer it will not cause CPU to wake up
* on expiry
* @QDF_TIMER_TYPE_WAKE_APPS: Non deferrable timer which will cause CPU to
* wake up on expiry
*/
typedef enum {
QDF_TIMER_TYPE_SW,
QDF_TIMER_TYPE_WAKE_APPS
} QDF_TIMER_TYPE;
/**
* tyepdef qdf_resource_type_t - hw resources
* @QDF_RESOURCE_TYPE_MEM: memory resource
* @QDF_RESOURCE_TYPE_IO: io resource
* Define the hw resources the OS has allocated for the device
* Note that start defines a mapped area.
*/
typedef enum {
QDF_RESOURCE_TYPE_MEM,
QDF_RESOURCE_TYPE_IO,
} qdf_resource_type_t;
/**
* tyepdef qdf_resource_t - representation of a h/w resource.
* @start: start
* @end: end
* @type: resource type
*/
typedef struct {
uint64_t start;
uint64_t end;
qdf_resource_type_t type;
} qdf_resource_t;
/**
* typedef qdf_dma_dir_t - DMA directions
* @QDF_DMA_BIDIRECTIONAL: bidirectional data
* @QDF_DMA_TO_DEVICE: data going from device to memory
* @QDF_DMA_FROM_DEVICE: data going from memory to device
*/
typedef enum {
QDF_DMA_BIDIRECTIONAL = __QDF_DMA_BIDIRECTIONAL,
QDF_DMA_TO_DEVICE = __QDF_DMA_TO_DEVICE,
QDF_DMA_FROM_DEVICE = __QDF_DMA_FROM_DEVICE,
} qdf_dma_dir_t;
/* work queue(kernel thread)/DPC function callback */
typedef void (*qdf_defer_fn_t)(void *);
/*
* Prototype of the critical region function that is to be
* executed with spinlock held and interrupt disalbed
*/
typedef bool (*qdf_irqlocked_func_t)(void *);
/* Prototype of timer function */
typedef void (*qdf_timer_func_t)(void *);
#define qdf_offsetof(type, field) offsetof(type, field)
/**
* typedef QDF_MODULE_ID - QDF Module IDs
* @QDF_MODULE_ID_TLSHIM: TLSHIM module ID
* @QDF_MODULE_ID_WMI: WMI module ID
* @QDF_MODULE_ID_HTT: HTT module ID
* @QDF_MODULE_ID_RSV4: Reserved
* @QDF_MODULE_ID_HDD: HDD module ID
* @QDF_MODULE_ID_SME: SME module ID
* @QDF_MODULE_ID_PE: PE module ID
* @QDF_MODULE_ID_WMA: WMA module ID
* @QDF_MODULE_ID_SYS: SYS module ID
* @QDF_MODULE_ID_QDF: QDF module ID
* @QDF_MODULE_ID_SAP: SAP module ID
* @QDF_MODULE_ID_HDD_SOFTAP: HDD SAP module ID
* @QDF_MODULE_ID_HDD_DATA: HDD DATA module ID
* @QDF_MODULE_ID_HDD_SAP_DATA: HDD SAP DATA module ID
* @QDF_MODULE_ID_HIF: HIF module ID
* @QDF_MODULE_ID_HTC: HTC module ID
* @QDF_MODULE_ID_TXRX: TXRX module ID
* @QDF_MODULE_ID_QDF_DEVICE: QDF DEVICE module ID
* @QDF_MODULE_ID_CFG: CFG module ID
* @QDF_MODULE_ID_BMI: BMI module ID
* @QDF_MODULE_ID_EPPING: EPPING module ID
* @QDF_MODULE_ID_QVIT: QVIT module ID
* @QDF_MODULE_ID_MAX: Max place holder module ID
*
* These are generic IDs that identify the various modules in the software
* system
* 0 is unused for historical purposes
* 3 & 4 are unused for historical purposes
*/
typedef enum {
QDF_MODULE_ID_TLSHIM = 1,
QDF_MODULE_ID_WMI = 2,
QDF_MODULE_ID_HTT = 3,
QDF_MODULE_ID_RSV4 = 4,
QDF_MODULE_ID_HDD = 5,
QDF_MODULE_ID_SME = 6,
QDF_MODULE_ID_PE = 7,
QDF_MODULE_ID_WMA = 8,
QDF_MODULE_ID_SYS = 9,
QDF_MODULE_ID_QDF = 10,
QDF_MODULE_ID_SAP = 11,
QDF_MODULE_ID_HDD_SOFTAP = 12,
QDF_MODULE_ID_HDD_DATA = 14,
QDF_MODULE_ID_HDD_SAP_DATA = 15,
QDF_MODULE_ID_HIF = 16,
QDF_MODULE_ID_HTC = 17,
QDF_MODULE_ID_TXRX = 18,
QDF_MODULE_ID_QDF_DEVICE = 19,
QDF_MODULE_ID_CFG = 20,
QDF_MODULE_ID_BMI = 21,
QDF_MODULE_ID_EPPING = 22,
QDF_MODULE_ID_QVIT = 23,
QDF_MODULE_ID_MAX
} QDF_MODULE_ID;
/**
* enum tQDF_ADAPTER_MODE - Concurrency role.
* @QDF_STA_MODE: STA mode
* @QDF_SAP_MODE: SAP mode
* @QDF_P2P_CLIENT_MODE: P2P client mode
* @QDF_P2P_GO_MODE: P2P GO mode
* @QDF_FTM_MODE: FTM mode
* @QDF_IBSS_MODE: IBSS mode
* @QDF_MONITOR_MODE: Monitor mode
* @QDF_P2P_DEVICE_MODE: P2P device mode
* @QDF_OCB_MODE: OCB device mode
* @QDF_EPPING_MODE: EPPING device mode
* @QDF_QVIT_MODE: QVIT device mode
* @QDF_NDI_MODE: NAN datapath mode
* @QDF_MAX_NO_OF_MODE: Max place holder
*
* These are generic IDs that identify the various roles
* in the software system
*/
enum tQDF_ADAPTER_MODE {
QDF_STA_MODE,
QDF_SAP_MODE,
QDF_P2P_CLIENT_MODE,
QDF_P2P_GO_MODE,
QDF_FTM_MODE,
QDF_IBSS_MODE,
QDF_MONITOR_MODE,
QDF_P2P_DEVICE_MODE,
QDF_OCB_MODE,
QDF_EPPING_MODE,
QDF_QVIT_MODE,
QDF_NDI_MODE,
QDF_MAX_NO_OF_MODE
};
/**
* enum tQDF_GLOBAL_CON_MODE - global config mode when
* driver is loaded.
*
* @QDF_GLOBAL_MISSION_MODE: mission mode (STA, SAP...)
* @QDF_GLOBAL_MONITOR_MODE: Monitor Mode
* @QDF_GLOBAL_FTM_MODE: FTM mode
* @QDF_GLOBAL_EPPING_MODE: EPPING mode
* @QDF_GLOBAL_QVIT_MODE: QVIT global mode
* @QDF_GLOBAL_MAX_MODE: Max place holder
*/
enum tQDF_GLOBAL_CON_MODE {
QDF_GLOBAL_MISSION_MODE,
QDF_GLOBAL_MONITOR_MODE = 4,
QDF_GLOBAL_FTM_MODE = 5,
QDF_GLOBAL_EPPING_MODE = 8,
QDF_GLOBAL_QVIT_MODE = 9,
QDF_GLOBAL_MAX_MODE
};
#define QDF_IS_EPPING_ENABLED(mode) (mode == QDF_GLOBAL_EPPING_MODE)
#ifdef CONFIG_MCL
#define qdf_print(args...) \
QDF_TRACE(QDF_MODULE_ID_QDF, QDF_TRACE_LEVEL_ERROR, ## args)
#else
#define qdf_print printk
#endif /* CONFIG_MCL */
#define qdf_vprint __qdf_vprint
#define qdf_snprint __qdf_snprint
#ifdef WLAN_OPEN_P2P_INTERFACE
/* This should match with WLAN_MAX_INTERFACES */
#define QDF_MAX_CONCURRENCY_PERSONA (4)
#else
#define QDF_MAX_CONCURRENCY_PERSONA (3)
#endif
#define QDF_STA_MASK (1 << QDF_STA_MODE)
#define QDF_SAP_MASK (1 << QDF_SAP_MODE)
#define QDF_P2P_CLIENT_MASK (1 << QDF_P2P_CLIENT_MODE)
#define QDF_P2P_GO_MASK (1 << QDF_P2P_GO_MODE)
#ifdef FEATURE_WLAN_MCC_TO_SCC_SWITCH
/**
* typedef tQDF_MCC_TO_SCC_SWITCH_MODE - MCC to SCC switch mode.
* @QDF_MCC_TO_SCC_SWITCH_DISABLE: Disable switch
* @QDF_MCC_TO_SCC_SWITCH_ENABLE: Enable switch
* @QDF_MCC_TO_SCC_SWITCH_FORCE: Force switch with SAP restart
* @QDF_MCC_TO_SCC_SWITCH_FORCE_WITHOUT_DISCONNECTION: Force switch without
* restart of SAP
* @QDF_MCC_TO_SCC_SWITCH_WITH_FAVORITE_CHANNEL: Switch using fav channel(s)
* without SAP restart
* @QDF_MCC_TO_SCC_SWITCH_MAX: max switch
*/
typedef enum {
QDF_MCC_TO_SCC_SWITCH_DISABLE = 0,
QDF_MCC_TO_SCC_SWITCH_ENABLE,
QDF_MCC_TO_SCC_SWITCH_FORCE,
QDF_MCC_TO_SCC_SWITCH_FORCE_WITHOUT_DISCONNECTION,
QDF_MCC_TO_SCC_SWITCH_WITH_FAVORITE_CHANNEL,
QDF_MCC_TO_SCC_SWITCH_MAX
} tQDF_MCC_TO_SCC_SWITCH_MODE;
#endif
#if !defined(NULL)
#ifdef __cplusplus
#define NULL 0
#else
#define NULL ((void *)0)
#endif
#endif
/* typedef for QDF Context... */
typedef void *v_CONTEXT_t;
#define QDF_MAC_ADDR_SIZE (6)
/**
* struct qdf_mac_addr - mac address array
* @bytes: MAC address bytes
*/
struct qdf_mac_addr {
uint8_t bytes[QDF_MAC_ADDR_SIZE];
};
/**
* This macro is used to initialize a QDF MacAddress to the broadcast
* MacAddress. It is used like this...
*/
#define QDF_MAC_ADDR_BROADCAST_INITIALIZER \
{ { 0xff, 0xff, 0xff, 0xff, 0xff, 0xff } }
/**
* This macro is used to initialize a QDF MacAddress to zero
* It is used like this...
*/
#define QDF_MAC_ADDR_ZERO_INITIALIZER { { 0, 0, 0, 0, 0, 0 } }
#define QDF_IPV4_ADDR_SIZE (4)
#define QDF_IPV6_ADDR_SIZE (16)
#define QDF_MAX_NUM_CHAN (128)
/**
* struct qdf_tso_frag_t - fragments of a single TCP segment
* @paddr_low_32: Lower 32 bits of the buffer pointer
* @paddr_upper_16: upper 16 bits of the buffer pointer
* @length: length of the buffer
* @vaddr: virtual address
*
* This structure holds the fragments of a single TCP segment of a
* given jumbo TSO network buffer
*/
struct qdf_tso_frag_t {
uint16_t length;
unsigned char *vaddr;
qdf_dma_addr_t paddr;
};
#define FRAG_NUM_MAX 6
/**
* struct qdf_tso_flags_t - TSO specific flags
* @tso_enable: Enable transmit segmentation offload
* @tcp_flags_mask: Tcp_flag is inserted into the header based
* on the mask
* @l2_len: L2 length for the msdu
* @ip_len: IP length for the msdu
* @tcp_seq_num: TCP sequence number
* @ip_id: IP identification number
*
* This structure holds the TSO specific flags extracted from the TSO network
* buffer for a given TCP segment
*/
struct qdf_tso_flags_t {
uint32_t tso_enable:1,
reserved_0a:6,
fin:1,
syn:1,
rst:1,
psh:1,
ack:1,
urg:1,
ece:1,
cwr:1,
ns:1,
tcp_flags_mask:9,
reserved_0b:7;
uint32_t l2_len:16,
ip_len:16;
uint32_t tcp_seq_num;
uint32_t ip_id:16,
ipv4_checksum_en:1,
udp_ipv4_checksum_en:1,
udp_ipv6_checksum_en:1,
tcp_ipv4_checksum_en:1,
tcp_ipv6_checksum_en:1,
partial_checksum_en:1,
reserved_3a:10;
uint32_t checksum_offset:14,
reserved_4a:2,
payload_start_offset:14,
reserved_4b:2;
uint32_t payload_end_offset:14,
reserved_5:18;
};
/**
* struct qdf_tso_seg_t - single TSO segment
* @tso_flags: TSO flags
* @num_frags: number of fragments
* @tso_frags: array holding the fragments
*
* This structure holds the information of a single TSO segment of a jumbo
* TSO network buffer
*/
struct qdf_tso_seg_t {
struct qdf_tso_flags_t tso_flags;
uint32_t num_frags;
struct qdf_tso_frag_t tso_frags[FRAG_NUM_MAX];
};
/**
* qdf_tso_seg_elem_t - tso segment element
* @seg: instance of segment
* @next: pointer to the next segment
*/
struct qdf_tso_seg_elem_t {
struct qdf_tso_seg_t seg;
struct qdf_tso_seg_elem_t *next;
};
/**
* struct qdf_tso_info_t - TSO information extracted
* @is_tso: is this is a TSO frame
* @num_segs: number of segments
* @total_len: total length of the packet
* @tso_seg_list: list of TSO segments for this jumbo packet
* @curr_seg: segment that is currently being processed
*
* This structure holds the TSO information extracted after parsing the TSO
* jumbo network buffer. It contains a chain of the TSO segments belonging to
* the jumbo packet
*/
struct qdf_tso_info_t {
uint8_t is_tso;
uint32_t num_segs;
uint32_t total_len;
struct qdf_tso_seg_elem_t *tso_seg_list;
struct qdf_tso_seg_elem_t *curr_seg;
};
/**
* Used to set classify bit in CE desc.
*/
#define QDF_CE_TX_CLASSIFY_BIT_S 5
/**
* QDF_CE_TX_PKT_TYPE_BIT_S - 2 bits starting at bit 6 in CE desc.
*/
#define QDF_CE_TX_PKT_TYPE_BIT_S 6
/**
* QDF_CE_TX_PKT_OFFSET_BIT_S - 12 bits --> 16-27, in the CE desciptor
* the length of HTT/HTC descriptor
*/
#define QDF_CE_TX_PKT_OFFSET_BIT_S 16
/**
* QDF_CE_TX_PKT_OFFSET_BIT_M - Mask for packet offset in the CE descriptor.
*/
#define QDF_CE_TX_PKT_OFFSET_BIT_M 0x0fff0000
/**
* enum qdf_suspend_type - type of suspend
* @QDF_SYSTEM_SUSPEND: System suspend triggered wlan suspend
* @QDF_RUNTIME_SUSPEND: Runtime pm inactivity timer triggered wlan suspend
*/
enum qdf_suspend_type {
QDF_SYSTEM_SUSPEND,
QDF_RUNTIME_SUSPEND
};
#endif /* __QDF_TYPES_H */