| /* |
| * OS Abstraction Layer |
| * |
| * Copyright (C) 1999-2019, 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. |
| * |
| * 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. |
| * |
| * |
| * <<Broadcom-WL-IPTag/Open:>> |
| * |
| * $Id: osl.h 813810 2019-04-08 12:25:30Z $ |
| */ |
| |
| #ifndef _osl_h_ |
| #define _osl_h_ |
| |
| #include <osl_decl.h> |
| |
| enum { |
| TAIL_BYTES_TYPE_FCS = 1, |
| TAIL_BYTES_TYPE_ICV = 2, |
| TAIL_BYTES_TYPE_MIC = 3 |
| }; |
| |
| #define OSL_PKTTAG_SZ 48 /* standard linux pkttag size is 48 bytes */ |
| |
| /* 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 <utest_osl.h> |
| #else |
| #include <linux_osl.h> |
| #include <linux_pkt.h> |
| #endif // endif |
| |
| #ifndef PKTDBG_TRACE |
| #define PKTDBG_TRACE(osh, pkt, bit) BCM_REFERENCE(osh) |
| #endif // 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_NOT_DEFINED 1 |
| #endif /* !defined(OSL_SYSUPTIME) */ |
| |
| #if !defined(OSL_SYSUPTIME_US) |
| #define OSL_SYSUPTIME_US() (0) |
| #define OSL_SYSUPTIME_US_NOT_DEFINED 1 |
| #endif /* !defined(OSL_SYSUPTIME) */ |
| |
| #if defined(OSL_SYSUPTIME_NOT_DEFINED) && defined(OSL_SYSUPTIME_US_NOT_DEFINED) |
| #define OSL_SYSUPTIME_SUPPORT FALSE |
| #else |
| #define OSL_SYSUPTIME_SUPPORT TRUE |
| #endif /* OSL_SYSUPTIME */ |
| |
| #ifndef OSL_GET_LOCALTIME |
| #define OSL_GET_LOCALTIME(sec, usec) \ |
| do { \ |
| BCM_REFERENCE(sec); \ |
| BCM_REFERENCE(usec); \ |
| } while (0) |
| #endif /* OSL_GET_LOCALTIME */ |
| |
| #ifndef OSL_LOCALTIME_NS |
| #define OSL_LOCALTIME_NS() (OSL_SYSUPTIME_US() * NSEC_PER_USEC) |
| #endif /* OSL_LOCALTIME_NS */ |
| |
| #ifndef OSL_SYSTZTIME_US |
| #define OSL_SYSTZTIME_US() OSL_SYSUPTIME_US() |
| #endif /* OSL_GET_SYSTZTIME */ |
| |
| #ifndef OSL_SYS_HALT |
| #define OSL_SYS_HALT() do {} while (0) |
| #endif // endif |
| |
| #ifndef DMB |
| #if defined(STB) |
| #define DMB() mb(); |
| #else /* STB */ |
| #define DMB() do {} while (0) |
| #endif /* STB */ |
| #endif /* DMB */ |
| |
| #ifndef OSL_MEM_AVAIL |
| #define OSL_MEM_AVAIL() (0xffffffff) |
| #endif // endif |
| |
| #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 */ |
| |
| #if !defined(PKTC_DONGLE) |
| |
| #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 // endif |
| |
| #ifndef PKTSETCHAINED |
| #define PKTSETCHAINED(osh, skb) BCM_REFERENCE(osh) |
| #endif // endif |
| #ifndef PKTCLRCHAINED |
| #define PKTCLRCHAINED(osh, skb) BCM_REFERENCE(osh) |
| #endif // endif |
| #ifndef PKTISCHAINED |
| #define PKTISCHAINED(skb) FALSE |
| #endif // endif |
| |
| /* Lbuf with fraglist */ |
| #ifndef PKTFRAGPKTID |
| #define PKTFRAGPKTID(osh, lb) (0) |
| #endif // endif |
| #ifndef PKTSETFRAGPKTID |
| #define PKTSETFRAGPKTID(osh, lb, id) BCM_REFERENCE(osh) |
| #endif // endif |
| #ifndef PKTFRAGTOTNUM |
| #define PKTFRAGTOTNUM(osh, lb) (0) |
| #endif // endif |
| #ifndef PKTSETFRAGTOTNUM |
| #define PKTSETFRAGTOTNUM(osh, lb, tot) BCM_REFERENCE(osh) |
| #endif // endif |
| #ifndef PKTFRAGTOTLEN |
| #define PKTFRAGTOTLEN(osh, lb) (0) |
| #endif // endif |
| #ifndef PKTSETFRAGTOTLEN |
| #define PKTSETFRAGTOTLEN(osh, lb, len) BCM_REFERENCE(osh) |
| #endif // endif |
| #ifndef PKTIFINDEX |
| #define PKTIFINDEX(osh, lb) (0) |
| #endif // endif |
| #ifndef PKTSETIFINDEX |
| #define PKTSETIFINDEX(osh, lb, idx) BCM_REFERENCE(osh) |
| #endif // endif |
| #ifndef PKTGETLF |
| #define PKTGETLF(osh, len, send, lbuf_type) (0) |
| #endif // endif |
| |
| /* in rx path, reuse totlen as used len */ |
| #ifndef PKTFRAGUSEDLEN |
| #define PKTFRAGUSEDLEN(osh, lb) (0) |
| #endif // endif |
| #ifndef PKTSETFRAGUSEDLEN |
| #define PKTSETFRAGUSEDLEN(osh, lb, len) BCM_REFERENCE(osh) |
| #endif // endif |
| #ifndef PKTFRAGLEN |
| #define PKTFRAGLEN(osh, lb, ix) (0) |
| #endif // endif |
| #ifndef PKTSETFRAGLEN |
| #define PKTSETFRAGLEN(osh, lb, ix, len) BCM_REFERENCE(osh) |
| #endif // endif |
| #ifndef PKTFRAGDATA_LO |
| #define PKTFRAGDATA_LO(osh, lb, ix) (0) |
| #endif // endif |
| #ifndef PKTSETFRAGDATA_LO |
| #define PKTSETFRAGDATA_LO(osh, lb, ix, addr) BCM_REFERENCE(osh) |
| #endif // endif |
| #ifndef PKTFRAGDATA_HI |
| #define PKTFRAGDATA_HI(osh, lb, ix) (0) |
| #endif // endif |
| #ifndef PKTSETFRAGDATA_HI |
| #define PKTSETFRAGDATA_HI(osh, lb, ix, addr) BCM_REFERENCE(osh) |
| #endif // endif |
| |
| /* RX FRAG */ |
| #ifndef PKTISRXFRAG |
| #define PKTISRXFRAG(osh, lb) (0) |
| #endif // endif |
| #ifndef PKTSETRXFRAG |
| #define PKTSETRXFRAG(osh, lb) BCM_REFERENCE(osh) |
| #endif // endif |
| #ifndef PKTRESETRXFRAG |
| #define PKTRESETRXFRAG(osh, lb) BCM_REFERENCE(osh) |
| #endif // endif |
| |
| /* TX FRAG */ |
| #ifndef PKTISTXFRAG |
| #define PKTISTXFRAG(osh, lb) (0) |
| #endif // endif |
| #ifndef PKTSETTXFRAG |
| #define PKTSETTXFRAG(osh, lb) BCM_REFERENCE(osh) |
| #endif // endif |
| |
| /* Need Rx completion used for AMPDU reordering */ |
| #ifndef PKTNEEDRXCPL |
| #define PKTNEEDRXCPL(osh, lb) (TRUE) |
| #endif // endif |
| #ifndef PKTSETNORXCPL |
| #define PKTSETNORXCPL(osh, lb) BCM_REFERENCE(osh) |
| #endif // endif |
| #ifndef PKTRESETNORXCPL |
| #define PKTRESETNORXCPL(osh, lb) BCM_REFERENCE(osh) |
| #endif // endif |
| #ifndef PKTISFRAG |
| #define PKTISFRAG(osh, lb) (0) |
| #endif // endif |
| #ifndef PKTFRAGISCHAINED |
| #define PKTFRAGISCHAINED(osh, i) (0) |
| #endif // 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 // endif |
| #ifndef PKTISHDRCONVTD |
| #define PKTISHDRCONVTD(osh, lb) (0) |
| #endif // endif |
| |
| /* Forwarded pkt indication */ |
| #ifndef PKTISFRWDPKT |
| #define PKTISFRWDPKT(osh, lb) 0 |
| #endif // endif |
| #ifndef PKTSETFRWDPKT |
| #define PKTSETFRWDPKT(osh, lb) BCM_REFERENCE(osh) |
| #endif // endif |
| #ifndef PKTRESETFRWDPKT |
| #define PKTRESETFRWDPKT(osh, lb) BCM_REFERENCE(osh) |
| #endif // endif |
| |
| /* SFD Frame */ |
| #ifndef PKTISSFDFRAME |
| #define PKTISSFDFRAME(osh, lb) (0) |
| #endif // endif |
| #ifndef PKTSETSFDFRAME |
| #define PKTSETSFDFRAME(osh, lb) BCM_REFERENCE(osh) |
| #endif // endif |
| #ifndef PKTRESETSFDFRAME |
| #define PKTRESETSFDFRAME(osh, lb) BCM_REFERENCE(osh) |
| #endif // endif |
| #ifndef PKTISSFDTXC |
| #define PKTISSFDTXC(osh, lb) (0) |
| #endif // endif |
| #ifndef PKTSETSFDTXC |
| #define PKTSETSFDTXC(osh, lb) BCM_REFERENCE(osh) |
| #endif // endif |
| #ifndef PKTRESETSFDTXC |
| #define PKTRESETSFDTXC(osh, lb) BCM_REFERENCE(osh) |
| #endif // 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) {.hiaddr = 0, .loaddr = 0}) |
| #endif // 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) {.hiaddr = 0, .loaddr = 0}) |
| #endif // 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 */ |
| |
| #ifndef MALLOC_NOPERSIST |
| #define MALLOC_NOPERSIST MALLOC |
| #endif /* !MALLOC_NOPERSIST */ |
| |
| #ifndef MALLOC_PERSIST |
| #define MALLOC_PERSIST MALLOC |
| #endif /* !MALLOC_PERSIST */ |
| |
| #ifndef MALLOC_NOPERSIST |
| #define MALLOC_NOPERSIST MALLOC |
| #endif /* !MALLOC_NOPERSIST */ |
| |
| #ifndef MALLOC_PERSIST_ATTACH |
| #define MALLOC_PERSIST_ATTACH MALLOC |
| #endif /* !MALLOC_PERSIST_ATTACH */ |
| |
| #ifndef MALLOCZ_PERSIST_ATTACH |
| #define MALLOCZ_PERSIST_ATTACH MALLOCZ |
| #endif /* !MALLOCZ_PERSIST_ATTACH */ |
| |
| #ifndef MALLOCZ_NOPERSIST |
| #define MALLOCZ_NOPERSIST MALLOCZ |
| #endif /* !MALLOCZ_NOPERSIST */ |
| |
| #ifndef MALLOCZ_PERSIST |
| #define MALLOCZ_PERSIST MALLOCZ |
| #endif /* !MALLOCZ_PERSIST */ |
| |
| #ifndef MFREE_PERSIST |
| #define MFREE_PERSIST MFREE |
| #endif /* !MFREE_PERSIST */ |
| |
| #ifndef MALLOC_SET_NOPERSIST |
| #define MALLOC_SET_NOPERSIST(osh) do { } while (0) |
| #endif /* !MALLOC_SET_NOPERSIST */ |
| |
| #ifndef MALLOC_CLEAR_NOPERSIST |
| #define MALLOC_CLEAR_NOPERSIST(osh) do { } while (0) |
| #endif /* !MALLOC_CLEAR_NOPERSIST */ |
| |
| #if defined(OSL_MEMCHECK) |
| #define MEMCHECK(f, l) osl_memcheck(f, l) |
| #else |
| #define MEMCHECK(f, l) |
| #endif /* OSL_MEMCHECK */ |
| |
| #endif /* _osl_h_ */ |
