/* * OS Abstraction Layer * * Copyright (C) 1999-2017, Broadcom Corporation * * 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. * * Notwithstanding the above, under no circumstances may you combine this * software in any way with any other Broadcom software provided under a license * other than the GPL, without Broadcom's express prior written consent. * * * <> * * $Id: osl.h 642189 2016-06-07 21:12:50Z $ */ #ifndef _osl_h_ #define _osl_h_ #include #define OSL_PKTTAG_SZ 32 /* Size of PktTag */ /* Drivers use PKTFREESETCB to register a callback function when a packet is freed by OSL */ typedef void (*pktfree_cb_fn_t)(void *ctx, void *pkt, unsigned int status); /* Drivers use REGOPSSET() to register register read/write funcitons */ typedef unsigned int (*osl_rreg_fn_t)(void *ctx, volatile void *reg, unsigned int size); typedef void (*osl_wreg_fn_t)(void *ctx, volatile void *reg, unsigned int val, unsigned int size); #if defined(WL_UNITTEST) #include #else #include #endif #ifndef PKTDBG_TRACE #define PKTDBG_TRACE(osh, pkt, bit) BCM_REFERENCE(osh) #endif #define PKTCTFMAP(osh, p) BCM_REFERENCE(osh) /* -------------------------------------------------------------------------- ** Register manipulation macros. */ #define SET_REG(osh, r, mask, val) W_REG((osh), (r), ((R_REG((osh), r) & ~(mask)) | (val))) #ifndef AND_REG #define AND_REG(osh, r, v) W_REG(osh, (r), R_REG(osh, r) & (v)) #endif /* !AND_REG */ #ifndef OR_REG #define OR_REG(osh, r, v) W_REG(osh, (r), R_REG(osh, r) | (v)) #endif /* !OR_REG */ #if !defined(OSL_SYSUPTIME) #define OSL_SYSUPTIME() (0) #define OSL_SYSUPTIME_SUPPORT FALSE #else #define OSL_SYSUPTIME_SUPPORT TRUE #endif /* OSL_SYSUPTIME */ #if !defined(OSL_SYSUPTIME_US) #define OSL_SYSUPTIME_US() (0) #endif /* OSL_SYSUPTIME */ #ifndef OSL_SYS_HALT #define OSL_SYS_HALT() do {} while (0) #endif #ifndef OSL_MEM_AVAIL #define OSL_MEM_AVAIL() (0xffffffff) #endif #if !(defined(PKTC) || defined(PKTC_DONGLE)) #ifndef OSL_OBFUSCATE_BUF /* For security reasons printing pointers is not allowed. * Some OSLs implement OSL_OBFUSCATE_BUF to OS specific obfuscate API. * If OSL_OBFUSCATE_BUF() is not implemented in OSL, then default to * printing the input pointer */ #define OSL_OBFUSCATE_BUF(x) (x) #endif /* OSL_OBFUSCATE_BUF */ #define PKTCGETATTR(skb) (0) #define PKTCSETATTR(skb, f, p, b) BCM_REFERENCE(skb) #define PKTCCLRATTR(skb) BCM_REFERENCE(skb) #define PKTCCNT(skb) (1) #define PKTCLEN(skb) PKTLEN(NULL, skb) #define PKTCGETFLAGS(skb) (0) #define PKTCSETFLAGS(skb, f) BCM_REFERENCE(skb) #define PKTCCLRFLAGS(skb) BCM_REFERENCE(skb) #define PKTCFLAGS(skb) (0) #define PKTCSETCNT(skb, c) BCM_REFERENCE(skb) #define PKTCINCRCNT(skb) BCM_REFERENCE(skb) #define PKTCADDCNT(skb, c) BCM_REFERENCE(skb) #define PKTCSETLEN(skb, l) BCM_REFERENCE(skb) #define PKTCADDLEN(skb, l) BCM_REFERENCE(skb) #define PKTCSETFLAG(skb, fb) BCM_REFERENCE(skb) #define PKTCCLRFLAG(skb, fb) BCM_REFERENCE(skb) #define PKTCLINK(skb) NULL #define PKTSETCLINK(skb, x) BCM_REFERENCE(skb) #define FOREACH_CHAINED_PKT(skb, nskb) \ for ((nskb) = NULL; (skb) != NULL; (skb) = (nskb)) #define PKTCFREE PKTFREE #define PKTCENQTAIL(h, t, p) \ do { \ if ((t) == NULL) { \ (h) = (t) = (p); \ } \ } while (0) #endif /* !linux || !PKTC */ #if !(defined(HNDCTF) || defined(PKTC_TX_DONGLE) || defined(PKTC)) #define PKTSETCHAINED(osh, skb) BCM_REFERENCE(osh) #define PKTCLRCHAINED(osh, skb) BCM_REFERENCE(osh) #define PKTISCHAINED(skb) FALSE #endif /* Lbuf with fraglist */ #ifndef PKTFRAGPKTID #define PKTFRAGPKTID(osh, lb) (0) #endif #ifndef PKTSETFRAGPKTID #define PKTSETFRAGPKTID(osh, lb, id) BCM_REFERENCE(osh) #endif #ifndef PKTFRAGTOTNUM #define PKTFRAGTOTNUM(osh, lb) (0) #endif #ifndef PKTSETFRAGTOTNUM #define PKTSETFRAGTOTNUM(osh, lb, tot) BCM_REFERENCE(osh) #endif #ifndef PKTFRAGTOTLEN #define PKTFRAGTOTLEN(osh, lb) (0) #endif #ifndef PKTSETFRAGTOTLEN #define PKTSETFRAGTOTLEN(osh, lb, len) BCM_REFERENCE(osh) #endif #ifndef PKTIFINDEX #define PKTIFINDEX(osh, lb) (0) #endif #ifndef PKTSETIFINDEX #define PKTSETIFINDEX(osh, lb, idx) BCM_REFERENCE(osh) #endif #ifndef PKTGETLF #define PKTGETLF(osh, len, send, lbuf_type) (0) #endif /* in rx path, reuse totlen as used len */ #ifndef PKTFRAGUSEDLEN #define PKTFRAGUSEDLEN(osh, lb) (0) #endif #ifndef PKTSETFRAGUSEDLEN #define PKTSETFRAGUSEDLEN(osh, lb, len) BCM_REFERENCE(osh) #endif #ifndef PKTFRAGLEN #define PKTFRAGLEN(osh, lb, ix) (0) #endif #ifndef PKTSETFRAGLEN #define PKTSETFRAGLEN(osh, lb, ix, len) BCM_REFERENCE(osh) #endif #ifndef PKTFRAGDATA_LO #define PKTFRAGDATA_LO(osh, lb, ix) (0) #endif #ifndef PKTSETFRAGDATA_LO #define PKTSETFRAGDATA_LO(osh, lb, ix, addr) BCM_REFERENCE(osh) #endif #ifndef PKTFRAGDATA_HI #define PKTFRAGDATA_HI(osh, lb, ix) (0) #endif #ifndef PKTSETFRAGDATA_HI #define PKTSETFRAGDATA_HI(osh, lb, ix, addr) BCM_REFERENCE(osh) #endif /* RX FRAG */ #ifndef PKTISRXFRAG #define PKTISRXFRAG(osh, lb) (0) #endif #ifndef PKTSETRXFRAG #define PKTSETRXFRAG(osh, lb) BCM_REFERENCE(osh) #endif #ifndef PKTRESETRXFRAG #define PKTRESETRXFRAG(osh, lb) BCM_REFERENCE(osh) #endif /* TX FRAG */ #ifndef PKTISTXFRAG #define PKTISTXFRAG(osh, lb) (0) #endif #ifndef PKTSETTXFRAG #define PKTSETTXFRAG(osh, lb) BCM_REFERENCE(osh) #endif /* Need Rx completion used for AMPDU reordering */ #ifndef PKTNEEDRXCPL #define PKTNEEDRXCPL(osh, lb) (TRUE) #endif #ifndef PKTSETNORXCPL #define PKTSETNORXCPL(osh, lb) BCM_REFERENCE(osh) #endif #ifndef PKTRESETNORXCPL #define PKTRESETNORXCPL(osh, lb) BCM_REFERENCE(osh) #endif #ifndef PKTISFRAG #define PKTISFRAG(osh, lb) (0) #endif #ifndef PKTFRAGISCHAINED #define PKTFRAGISCHAINED(osh, i) (0) #endif /* TRIM Tail bytes from lfrag */ #ifndef PKTFRAG_TRIM_TAILBYTES #define PKTFRAG_TRIM_TAILBYTES(osh, p, len, type) PKTSETLEN(osh, p, PKTLEN(osh, p) - len) #endif #ifndef PKTISHDRCONVTD #define PKTISHDRCONVTD(osh, lb) (0) #endif #ifdef BCM_SECURE_DMA #define SECURE_DMA_ENAB(osh) (1) #else #define SECURE_DMA_ENAB(osh) (0) #ifndef BCMDMA64OSL #define SECURE_DMA_MAP(osh, va, size, direction, p, dmah, pcma, offset) ((dmaaddr_t) ((0))) #else #define SECURE_DMA_MAP(osh, va, size, direction, p, dmah, pcma, offset) ((dmaaddr_t) {(0)}) #endif #define SECURE_DMA_DD_MAP(osh, va, size, direction, p, dmah) 0 #ifndef BCMDMA64OSL #define SECURE_DMA_MAP_TXMETA(osh, va, size, direction, p, dmah, pcma) ((dmaaddr_t) ((0))) #else #define SECURE_DMA_MAP_TXMETA(osh, va, size, direction, p, dmah, pcma) ((dmaaddr_t) {(0)}) #endif #define SECURE_DMA_UNMAP(osh, pa, size, direction, p, dmah, pcma, offset) #define SECURE_DMA_UNMAP_ALL(osh, pcma) #endif /* BCMDMA64OSL */ #ifndef ROMMABLE_ASSERT #define ROMMABLE_ASSERT(exp) ASSERT(exp) #endif /* ROMMABLE_ASSERT */ #endif /* _osl_h_ */