/* $NetBSD: atwvar.h,v 1.40 2019/10/05 23:27:20 mrg Exp $ */
/*
* Copyright (c) 2003, 2004 The NetBSD Foundation, Inc. All rights reserved.
*
* This code is derived from software contributed to The NetBSD Foundation
* by David Young.
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions
* are met:
* 1. Redistributions of source code must retain the above copyright
* notice, this list of conditions and the following disclaimer.
* 2. Redistributions in binary form must reproduce the above copyright
* notice, this list of conditions and the following disclaimer in the
* documentation and/or other materials provided with the distribution.
*
* THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
* ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
* TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
* PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
* BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
* CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
* SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
* INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
* CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
* ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
* POSSIBILITY OF SUCH DAMAGE.
*/
#ifndef _DEV_IC_ATWVAR_H_
#define _DEV_IC_ATWVAR_H_
#include <sys/queue.h>
#include <sys/callout.h>
#include <sys/time.h>
/*
* Transmit descriptor list size. This is arbitrary, but allocate
* enough descriptors for 64 pending transmissions and 16 segments
* per packet. Since a descriptor holds 2 buffer addresses, that's
* 8 descriptors per packet. This MUST work out to a power of 2.
*/
#define ATW_NTXSEGS 16
#define ATW_TXQUEUELEN 64
#define ATW_NTXDESC (ATW_TXQUEUELEN * ATW_NTXSEGS)
#define ATW_NTXDESC_MASK (ATW_NTXDESC - 1)
#define ATW_NEXTTX(x) ((x + 1) & ATW_NTXDESC_MASK)
/*
* Receive descriptor list size. We have one Rx buffer per incoming
* packet, so this logic is a little simpler.
*/
#define ATW_NRXDESC 64
#define ATW_NRXDESC_MASK (ATW_NRXDESC - 1)
#define ATW_NEXTRX(x) ((x + 1) & ATW_NRXDESC_MASK)
/*
* Control structures are DMA'd to the ADM8211 chip. We allocate them in
* a single clump that maps to a single DMA segment to make several things
* easier.
*/
struct atw_control_data {
/*
* The transmit descriptors.
*/
struct atw_txdesc acd_txdescs[ATW_NTXDESC];
/*
* The receive descriptors.
*/
struct atw_rxdesc acd_rxdescs[ATW_NRXDESC];
};
#define ATW_CDOFF(x) offsetof(struct atw_control_data, x)
#define ATW_CDTXOFF(x) ATW_CDOFF(acd_txdescs[(x)])
#define ATW_CDRXOFF(x) ATW_CDOFF(acd_rxdescs[(x)])
/*
* Software state for transmit jobs.
*/
struct atw_txsoft {
struct mbuf *txs_mbuf; /* head of our mbuf chain */
bus_dmamap_t txs_dmamap; /* our DMA map */
int txs_firstdesc; /* first descriptor in packet */
int txs_lastdesc; /* last descriptor in packet */
int txs_ndescs; /* number of descriptors */
struct ieee80211_duration txs_d0;
struct ieee80211_duration txs_dn;
SIMPLEQ_ENTRY(atw_txsoft) txs_q;
};
SIMPLEQ_HEAD(atw_txsq, atw_txsoft);
/*
* Software state for receive jobs.
*/
struct atw_rxsoft {
struct mbuf *rxs_mbuf; /* head of our mbuf chain */
bus_dmamap_t rxs_dmamap; /* our DMA map */
};
/*
* Table which describes the transmit threshold mode. We generally
* start at index 0. Whenever we get a transmit underrun, we increment
* our index, falling back if we encounter the NULL terminator.
*/
struct atw_txthresh_tab {
u_int32_t txth_opmode; /* OPMODE bits */
const char *txth_name; /* name of mode */
};
#define ATW_TXTHRESH_TAB_LO_RATE { \
{ ATW_NAR_TR_L64, "64 bytes" }, \
{ ATW_NAR_TR_L160, "160 bytes" }, \
{ ATW_NAR_TR_L192, "192 bytes" }, \
{ ATW_NAR_SF, "store and forward" }, \
{ 0, NULL }, \
}
#define ATW_TXTHRESH_TAB_HI_RATE { \
{ ATW_NAR_TR_H96, "96 bytes" }, \
{ ATW_NAR_TR_H288, "288 bytes" }, \
{ ATW_NAR_TR_H544, "544 bytes" }, \
{ ATW_NAR_SF, "store and forward" }, \
{ 0, NULL }, \
}
enum atw_rftype { ATW_RFTYPE_INTERSIL = 0, ATW_RFTYPE_RFMD = 1,
ATW_RFTYPE_MARVEL = 2 };
enum atw_bbptype { ATW_BBPTYPE_INTERSIL = 0, ATW_BBPTYPE_RFMD = 1,
ATW_BBPTYPE_MARVEL = 2, ATW_C_BBPTYPE_RFMD = 5 };
/* Radio capture format for ADMtek. */
#define ATW_RX_RADIOTAP_PRESENT \
((1 << IEEE80211_RADIOTAP_FLAGS) | (1 << IEEE80211_RADIOTAP_RATE) | \
(1 << IEEE80211_RADIOTAP_CHANNEL) | \
(1 << IEEE80211_RADIOTAP_DB_ANTSIGNAL))
struct atw_rx_radiotap_header {
struct ieee80211_radiotap_header ar_ihdr;
uint8_t ar_flags;
uint8_t ar_rate;
uint16_t ar_chan_freq;
uint16_t ar_chan_flags;
uint8_t ar_antsignal;
};
#define ATW_TX_RADIOTAP_PRESENT ((1 << IEEE80211_RADIOTAP_RATE) | \
(1 << IEEE80211_RADIOTAP_CHANNEL))
struct atw_tx_radiotap_header {
struct ieee80211_radiotap_header at_ihdr;
uint8_t at_rate;
uint8_t at_pad;
uint16_t at_chan_freq;
uint16_t at_chan_flags;
};
enum atw_revision {
ATW_REVISION_AB = 0x11, /* ADM8211A */
ATW_REVISION_AF = 0x15, /* ADM8211A? */
ATW_REVISION_BA = 0x20, /* ADM8211B */
ATW_REVISION_CA = 0x30 /* ADM8211C/CR */
};
struct atw_softc {
device_t sc_dev;
device_suspensor_t sc_suspensor;
pmf_qual_t sc_qual;
struct ethercom sc_ec;
struct ieee80211com sc_ic;
int (*sc_newstate)(struct ieee80211com *,
enum ieee80211_state, int);
void (*sc_recv_mgmt)(struct ieee80211com *,
struct mbuf *, struct ieee80211_node *,
int, int, u_int32_t);
struct ieee80211_node *(*sc_node_alloc)(struct ieee80211_node_table*);
void (*sc_node_free)(struct ieee80211_node *);
void *sc_soft_ih;
int sc_tx_timer;
int sc_rescan_timer;
bus_space_tag_t sc_st; /* bus space tag */
bus_space_handle_t sc_sh; /* bus space handle */
bus_dma_tag_t sc_dmat; /* bus dma tag */
u_int32_t sc_cacheline; /* cache line size */
u_int32_t sc_maxburst; /* maximum burst length */
const struct atw_txthresh_tab *sc_txth;
int sc_txthresh; /* current tx threshold */
u_int sc_cur_chan; /* current channel */
int sc_flags;
u_int16_t *sc_srom;
u_int16_t sc_sromsz;
struct bpf_if * sc_radiobpf;
bus_dma_segment_t sc_cdseg; /* control data memory */
int sc_cdnseg; /* number of segments */
bus_dmamap_t sc_cddmamap; /* control data DMA map */
#define sc_cddma sc_cddmamap->dm_segs[0].ds_addr
/*
* Software state for transmit and receive descriptors.
*/
struct atw_txsoft sc_txsoft[ATW_TXQUEUELEN];
struct atw_rxsoft sc_rxsoft[ATW_NRXDESC];
/*
* Control data structures.
*/
struct atw_control_data *sc_control_data;
#define sc_txdescs sc_control_data->acd_txdescs
#define sc_rxdescs sc_control_data->acd_rxdescs
#define sc_setup_desc sc_control_data->acd_setup_desc
int sc_txfree; /* number of free Tx descriptors */
int sc_txnext; /* next ready Tx descriptor */
int sc_ntxsegs; /* number of transmit segs per pkt */
struct atw_txsq sc_txfreeq; /* free Tx descsofts */
struct atw_txsq sc_txdirtyq; /* dirty Tx descsofts */
int sc_rxptr; /* next ready RX descriptor/descsoft */
u_int32_t sc_busmode; /* copy of ATW_PAR */
u_int32_t sc_opmode; /* copy of ATW_NAR */
u_int32_t sc_inten; /* copy of ATW_IER */
u_int32_t sc_wepctl; /* copy of ATW_WEPCTL */
u_int32_t sc_rxint_mask; /* mask of Rx interrupts we want */
u_int32_t sc_txint_mask; /* mask of Tx interrupts we want */
u_int32_t sc_linkint_mask;/* link-state interrupts mask */
enum atw_rftype sc_rftype;
enum atw_bbptype sc_bbptype;
u_int32_t sc_synctl_rd;
u_int32_t sc_synctl_wr;
u_int32_t sc_bbpctl_rd;
u_int32_t sc_bbpctl_wr;
void (*sc_recv_beacon)(struct ieee80211com *, struct mbuf *,
int, u_int32_t);
void (*sc_recv_prresp)(struct ieee80211com *, struct mbuf *,
int, u_int32_t);
/* ADM8211 state variables. */
u_int8_t sc_sram[ATW_SRAM_MAXSIZE];
u_int sc_sramlen;
u_int8_t sc_bssid[IEEE80211_ADDR_LEN];
uint8_t sc_rev;
uint8_t sc_rf3000_options1;
uint8_t sc_rf3000_options2;
struct evcnt sc_misc_ev;
struct evcnt sc_workaround1_ev;
struct evcnt sc_rxamatch_ev;
struct evcnt sc_rxpkt1in_ev;
struct evcnt sc_xmit_ev;
struct evcnt sc_tuf_ev; /* transmit underflow errors */
struct evcnt sc_tro_ev; /* transmit overrun */
struct evcnt sc_trt_ev; /* retry count exceeded */
struct evcnt sc_tlt_ev; /* lifetime exceeded */
struct evcnt sc_sofbr_ev; /* packet size mismatch */
struct evcnt sc_recv_ev;
struct evcnt sc_crc16e_ev;
struct evcnt sc_crc32e_ev;
struct evcnt sc_icve_ev;
struct evcnt sc_sfde_ev;
struct evcnt sc_sige_ev;
struct callout sc_scan_ch;
union {
struct atw_rx_radiotap_header tap;
u_int8_t pad[64];
} sc_rxtapu;
union {
struct atw_tx_radiotap_header tap;
u_int8_t pad[64];
} sc_txtapu;
};
#define sc_if sc_ec.ec_if
#define sc_rxtap sc_rxtapu.tap
#define sc_txtap sc_txtapu.tap
/* XXX this is fragile. try not to introduce any u_int32_t's. */
struct atw_frame {
/*00*/ u_int8_t atw_dst[IEEE80211_ADDR_LEN];
/*06*/ u_int8_t atw_rate; /* TX rate in 100Kbps */
/*07*/ u_int8_t atw_service; /* 0 */
/*08*/ u_int16_t atw_paylen; /* payload length */
/*0a*/ u_int8_t atw_fc[2]; /* 802.11 Frame
* Control
*/
/* 802.11 PLCP Length for first & last fragment */
/*0c*/ u_int16_t atw_tail_plcplen;
/*0e*/ u_int16_t atw_head_plcplen;
/* 802.11 Duration for first & last fragment */
/*10*/ u_int16_t atw_tail_dur;
/*12*/ u_int16_t atw_head_dur;
/*14*/ u_int8_t atw_addr4[IEEE80211_ADDR_LEN];
union {
struct {
/*1a*/ u_int16_t hdrctl; /*transmission control*/
/*1c*/ u_int16_t fragthr;/* fragmentation threshold
* [0:11], zero [12:15].
*/
/*1e*/ u_int8_t fragnum;/* fragment number [4:7],
* zero [0:3].
*/
/*1f*/ u_int8_t rtylmt; /* retry limit */
/*20*/ u_int8_t wepkey0[4];/* ??? */
/*24*/ u_int8_t wepkey1[4];/* ??? */
/*28*/ u_int8_t wepkey2[4];/* ??? */
/*2c*/ u_int8_t wepkey3[4];/* ??? */
/*30*/ u_int8_t keyid;
/*31*/ u_int8_t reserved0[7];
} s1;
struct {
u_int8_t pad[6];
struct ieee80211_frame ihdr;
} s2;
} u;
} __packed;
#define atw_hdrctl u.s1.hdrctl
#define atw_fragthr u.s1.fragthr
#define atw_fragnum u.s1.fragnum
#define atw_rtylmt u.s1.rtylmt
#define atw_keyid u.s1.keyid
#define atw_ihdr u.s2.ihdr
#define ATW_HDRCTL_SHORT_PREAMBLE __BIT(0) /* use short preamble */
#define ATW_HDRCTL_MORE_FRAG __BIT(1) /* ??? from Linux */
#define ATW_HDRCTL_MORE_DATA __BIT(2) /* ??? from Linux */
#define ATW_HDRCTL_FRAG_NUM __BIT(3) /* ??? from Linux */
#define ATW_HDRCTL_RTSCTS __BIT(4) /* send RTS */
#define ATW_HDRCTL_WEP __BIT(5)
/* MAC adds FCS? Linux calls this "enable extended header" */
#define ATW_HDRCTL_UNKNOWN1 __BIT(15)
#define ATW_HDRCTL_UNKNOWN2 __BIT(8)
#define ATW_FRAGTHR_FRAGTHR_MASK __BITS(0, 11)
#define ATW_FRAGNUM_FRAGNUM_MASK __BITS(4, 7)
/* Values for sc_flags. */
#define ATWF_MRL 0x00000001 /* memory read line okay */
#define ATWF_MRM 0x00000002 /* memory read multi okay */
#define ATWF_MWI 0x00000004 /* memory write inval okay */
#define ATWF_SHORT_PREAMBLE 0x00000008 /* short preamble enabled */
#define ATWF_ATTACHED 0x00000010 /* attach has succeeded */
#define ATWF_ENABLED 0x00000020 /* chip is enabled */
#define ATWF_WEP_SRAM_VALID 0x00000040 /* SRAM matches s/w state */
#define ATW_CDTXADDR(sc, x) ((sc)->sc_cddma + ATW_CDTXOFF((x)))
#define ATW_CDRXADDR(sc, x) ((sc)->sc_cddma + ATW_CDRXOFF((x)))
#define ATW_CDTXSYNC(sc, x, n, ops) \
do { \
int __x, __n; \
\
__x = (x); \
__n = (n); \
\
/* If it will wrap around, sync to the end of the ring. */ \
if ((__x + __n) > ATW_NTXDESC) { \
bus_dmamap_sync((sc)->sc_dmat, (sc)->sc_cddmamap, \
ATW_CDTXOFF(__x), sizeof(struct atw_txdesc) * \
(ATW_NTXDESC - __x), (ops)); \
__n -= (ATW_NTXDESC - __x); \
__x = 0; \
} \
\
/* Now sync whatever is left. */ \
bus_dmamap_sync((sc)->sc_dmat, (sc)->sc_cddmamap, \
ATW_CDTXOFF(__x), sizeof(struct atw_txdesc) * __n, (ops)); \
} while (0)
#define ATW_CDRXSYNC(sc, x, ops) \
bus_dmamap_sync((sc)->sc_dmat, (sc)->sc_cddmamap, \
ATW_CDRXOFF((x)), sizeof(struct atw_rxdesc), (ops))
/*
* Note we rely on MCLBYTES being a power of two. Because the `length'
* field is only 11 bits, we must subtract 1 from the length to avoid
* having it truncated to 0!
*/
static __inline void
atw_init_rxdesc(struct atw_softc *sc, int x)
{
struct atw_rxsoft *rxs = &sc->sc_rxsoft[x];
struct atw_rxdesc *rxd = &sc->sc_rxdescs[x];
struct mbuf *m = rxs->rxs_mbuf;
rxd->ar_buf1 =
htole32(rxs->rxs_dmamap->dm_segs[0].ds_addr);
rxd->ar_buf2 = /* for descriptor chaining */
htole32(ATW_CDRXADDR((sc), ATW_NEXTRX(x)));
rxd->ar_ctlrssi =
htole32(__SHIFTIN(((m->m_ext.ext_size - 1) & ~0x3U),
ATW_RXCTL_RBS1_MASK) |
0 /* ATW_RXCTL_RCH */ |
(x == (ATW_NRXDESC - 1) ? ATW_RXCTL_RER : 0));
rxd->ar_stat = htole32(ATW_RXSTAT_OWN);
ATW_CDRXSYNC((sc), x, BUS_DMASYNC_PREREAD|BUS_DMASYNC_PREWRITE);
}
/* country codes from ADM8211 SROM */
#define ATW_COUNTRY_FCC 0 /* USA 1-11 */
#define ATW_COUNTRY_IC 1 /* Canada 1-11 */
#define ATW_COUNTRY_ETSI 2 /* European Union (?) 1-13 */
#define ATW_COUNTRY_SPAIN 3 /* 10-11 */
#define ATW_COUNTRY_FRANCE 4 /* 10-13 */
#define ATW_COUNTRY_MKK 5 /* Japan: 14 */
#define ATW_COUNTRY_MKK2 6 /* Japan: 1-14 */
/*
* register space access macros
*/
#define ATW_READ(sc, reg) \
bus_space_read_4((sc)->sc_st, (sc)->sc_sh, (reg))
#define ATW_WRITE(sc, reg, val) \
bus_space_write_4((sc)->sc_st, (sc)->sc_sh, (reg), (val))
#define ATW_SET(sc, reg, mask) \
ATW_WRITE((sc), (reg), ATW_READ((sc), (reg)) | (mask))
#define ATW_CLR(sc, reg, mask) \
ATW_WRITE((sc), (reg), ATW_READ((sc), (reg)) & ~(mask))
#define ATW_ISSET(sc, reg, mask) \
(ATW_READ((sc), (reg)) & (mask))
void atw_attach(struct atw_softc *);
int atw_detach(struct atw_softc *);
int atw_activate(device_t, enum devact);
int atw_intr(void *arg);
bool atw_shutdown(device_t, int);
bool atw_suspend(device_t, const pmf_qual_t *);
#endif /* _DEV_IC_ATWVAR_H_ */