root/sys/dev/ral/rt2860var.h
/*-
 * Copyright (c) 2007 Damien Bergamini <damien.bergamini@free.fr>
 * Copyright (c) 2012 Bernhard Schmidt <bschmidt@FreeBSD.org>
 *
 * Permission to use, copy, modify, and 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.
 *
 * $OpenBSD: rt2860var.h,v 1.20 2010/09/07 16:21:42 deraadt Exp $
 */

#define RT2860_TX_RING_COUNT    64
#define RT2860_RX_RING_COUNT    128
#define RT2860_TX_POOL_COUNT    (RT2860_TX_RING_COUNT * 2)

#define RT2860_MAX_SCATTER      ((RT2860_TX_RING_COUNT * 2) - 1)

/* HW supports up to 255 STAs */
#define RT2860_WCID_MAX         254
#define RT2860_AID2WCID(aid)    ((aid) & 0xff)

struct rt2860_rx_radiotap_header {
        struct ieee80211_radiotap_header wr_ihdr;
        uint64_t        wr_tsf;
        uint8_t         wr_flags;
        uint8_t         wr_rate;
        uint16_t        wr_chan_freq;
        uint16_t        wr_chan_flags;
        uint8_t         wr_antenna;
        int8_t          wr_antsignal;
        int8_t          wr_antnoise;
} __packed __aligned(8);

#define RT2860_RX_RADIOTAP_PRESENT                                      \
        ((1 << IEEE80211_RADIOTAP_TSFT) |                               \
         (1 << IEEE80211_RADIOTAP_FLAGS) |                              \
         (1 << IEEE80211_RADIOTAP_RATE) |                               \
         (1 << IEEE80211_RADIOTAP_CHANNEL) |                            \
         (1 << IEEE80211_RADIOTAP_ANTENNA) |                            \
         (1 << IEEE80211_RADIOTAP_DBM_ANTSIGNAL) |                      \
         (1 << IEEE80211_RADIOTAP_DBM_ANTNOISE))

struct rt2860_tx_radiotap_header {
        struct ieee80211_radiotap_header wt_ihdr;
        uint8_t         wt_flags;
        uint8_t         wt_rate;
        uint16_t        wt_chan_freq;
        uint16_t        wt_chan_flags;
} __packed;

#define RT2860_TX_RADIOTAP_PRESENT                                      \
        ((1 << IEEE80211_RADIOTAP_FLAGS) |                              \
         (1 << IEEE80211_RADIOTAP_RATE) |                               \
         (1 << IEEE80211_RADIOTAP_CHANNEL))

struct rt2860_tx_data {
        struct rt2860_txwi              *txwi;
        struct mbuf                     *m;
        struct ieee80211_node           *ni;
        bus_dmamap_t                    map;
        bus_addr_t                      paddr;
        SLIST_ENTRY(rt2860_tx_data)     next;
};

struct rt2860_tx_ring {
        struct rt2860_txd       *txd;
        bus_addr_t              paddr;
        bus_dma_tag_t           desc_dmat;
        bus_dmamap_t            desc_map;
        bus_dma_segment_t       seg;
        struct rt2860_tx_data   *data[RT2860_TX_RING_COUNT];
        int                     cur;
        int                     next;
        int                     queued;
};

struct rt2860_rx_data {
        struct mbuf     *m;
        bus_dmamap_t    map;
};

struct rt2860_rx_ring {
        struct rt2860_rxd       *rxd;
        bus_addr_t              paddr;
        bus_dma_tag_t           desc_dmat;
        bus_dmamap_t            desc_map;
        bus_dma_tag_t           data_dmat;
        bus_dma_segment_t       seg;
        unsigned int            cur;    /* must be unsigned */
        struct rt2860_rx_data   data[RT2860_RX_RING_COUNT];
};

struct rt2860_node {
        struct ieee80211_node   ni;
        uint8_t                 wcid;
        uint8_t                 ridx[IEEE80211_RATE_MAXSIZE];
        uint8_t                 ctl_ridx[IEEE80211_RATE_MAXSIZE];
};

struct rt2860_vap {
        struct ieee80211vap     ral_vap;

        int                     (*ral_newstate)(struct ieee80211vap *,
                                    enum ieee80211_state, int);
};
#define RT2860_VAP(vap)         ((struct rt2860_vap *)(vap))

struct rt2860_softc {
        struct ieee80211com             sc_ic;
        struct ieee80211_ratectl_tx_status sc_txs;
        struct mbufq                    sc_snd;
        struct mtx                      sc_mtx;
        device_t                        sc_dev;
        bus_space_tag_t                 sc_st;
        bus_space_handle_t              sc_sh;

        struct callout                  watchdog_ch;

        int                             sc_invalid;
        int                             sc_debug;
/*
 * The same in both up to here
 * ------------------------------------------------
 */

        uint16_t                        (*sc_srom_read)(struct rt2860_softc *,
                                            uint16_t);
        void                            (*sc_node_free)(struct ieee80211_node *);

        int                             sc_flags;
#define RT2860_ENABLED          (1 << 0)
#define RT2860_ADVANCED_PS      (1 << 1)
#define RT2860_PCIE             (1 << 2)
#define RT2860_RUNNING          (1 << 3)

        struct ieee80211_node           *wcid2ni[RT2860_WCID_MAX + 1];

        struct rt2860_tx_ring           txq[6];
        struct rt2860_rx_ring           rxq;

        SLIST_HEAD(, rt2860_tx_data)    data_pool;
        struct rt2860_tx_data           data[RT2860_TX_POOL_COUNT];
        bus_dma_tag_t                   txwi_dmat;
        bus_dmamap_t                    txwi_map;
        bus_dma_segment_t               txwi_seg;
        caddr_t                         txwi_vaddr;

        int                             sc_tx_timer;
        int                             mgtqid;
        uint8_t                         qfullmsk;

        uint16_t                        mac_ver;
        uint16_t                        mac_rev;
        uint16_t                        rf_rev;
        uint8_t                         freq;
        uint8_t                         ntxchains;
        uint8_t                         nrxchains;
        uint8_t                         pslevel;
        int8_t                          txpow1[54];
        int8_t                          txpow2[54];
        int8_t                          rssi_2ghz[3];
        int8_t                          rssi_5ghz[3];
        uint8_t                         lna[4];
        uint8_t                         rf24_20mhz;
        uint8_t                         rf24_40mhz;
        uint8_t                         patch_dac;
        uint8_t                         rfswitch;
        uint8_t                         ext_2ghz_lna;
        uint8_t                         ext_5ghz_lna;
        uint8_t                         calib_2ghz;
        uint8_t                         calib_5ghz;
        uint8_t                         txmixgain_2ghz;
        uint8_t                         txmixgain_5ghz;
        uint8_t                         tssi_2ghz[9];
        uint8_t                         tssi_5ghz[9];
        uint8_t                         step_2ghz;
        uint8_t                         step_5ghz;
        struct {
                uint8_t reg;
                uint8_t val;
        }                               bbp[8], rf[10];
        uint8_t                         leds;
        uint16_t                        led[3];
        uint32_t                        txpow20mhz[5];
        uint32_t                        txpow40mhz_2ghz[5];
        uint32_t                        txpow40mhz_5ghz[5];

        struct rt2860_rx_radiotap_header sc_rxtap;
        struct rt2860_tx_radiotap_header sc_txtap;
};

int     rt2860_attach(device_t, int);
int     rt2860_detach(void *);
void    rt2860_shutdown(void *);
void    rt2860_suspend(void *);
void    rt2860_resume(void *);
void    rt2860_intr(void *);

#define RAL_LOCK(sc)            mtx_lock(&(sc)->sc_mtx)
#define RAL_LOCK_ASSERT(sc)     mtx_assert(&(sc)->sc_mtx, MA_OWNED)
#define RAL_UNLOCK(sc)          mtx_unlock(&(sc)->sc_mtx)