The Design and Implementation of the FreeBSD Operating System, Second Edition
Now available: The Design and Implementation of the FreeBSD Operating System (Second Edition)


[ source navigation ] [ diff markup ] [ identifier search ] [ freetext search ] [ file search ] [ list types ] [ track identifier ]

FreeBSD/Linux Kernel Cross Reference
sys/dev/malo/if_malohal.h

Version: -  FREEBSD  -  FREEBSD-13-STABLE  -  FREEBSD-13-0  -  FREEBSD-12-STABLE  -  FREEBSD-12-0  -  FREEBSD-11-STABLE  -  FREEBSD-11-0  -  FREEBSD-10-STABLE  -  FREEBSD-10-0  -  FREEBSD-9-STABLE  -  FREEBSD-9-0  -  FREEBSD-8-STABLE  -  FREEBSD-8-0  -  FREEBSD-7-STABLE  -  FREEBSD-7-0  -  FREEBSD-6-STABLE  -  FREEBSD-6-0  -  FREEBSD-5-STABLE  -  FREEBSD-5-0  -  FREEBSD-4-STABLE  -  FREEBSD-3-STABLE  -  FREEBSD22  -  l41  -  OPENBSD  -  linux-2.6  -  MK84  -  PLAN9  -  xnu-8792 
SearchContext: -  none  -  3  -  10 

    1 /*-
    2  * Copyright (c) 2007 Marvell Semiconductor, Inc.
    3  * Copyright (c) 2007 Sam Leffler, Errno Consulting
    4  * Copyright (c) 2008 Weongyo Jeong <weongyo@freebsd.org>
    5  * All rights reserved.
    6  *
    7  * Redistribution and use in source and binary forms, with or without
    8  * modification, are permitted provided that the following conditions
    9  * are met:
   10  * 1. Redistributions of source code must retain the above copyright
   11  *    notice, this list of conditions and the following disclaimer,
   12  *    without modification.
   13  * 2. Redistributions in binary form must reproduce at minimum a disclaimer
   14  *    similar to the "NO WARRANTY" disclaimer below ("Disclaimer") and any
   15  *    redistribution must be conditioned upon including a substantially
   16  *    similar Disclaimer requirement for further binary redistribution.
   17  *
   18  * NO WARRANTY
   19  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
   20  * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
   21  * LIMITED TO, THE IMPLIED WARRANTIES OF NONINFRINGEMENT, MERCHANTIBILITY
   22  * AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL
   23  * THE COPYRIGHT HOLDERS OR CONTRIBUTORS BE LIABLE FOR SPECIAL, EXEMPLARY,
   24  * OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
   25  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
   26  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
   27  * IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
   28  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF
   29  * THE POSSIBILITY OF SUCH DAMAGES.
   30  *
   31  * $FreeBSD: releng/10.0/sys/dev/malo/if_malohal.h 218909 2011-02-21 09:01:34Z brucec $
   32  */
   33 
   34 #ifndef _DEV_MALOHAL_H
   35 #define _DEV_MALOHAL_H
   36 
   37 #define MALO_NUM_TX_QUEUES                      1
   38 #define MALO_MAX_TXWCB_QUEUES                   MALO_NUM_TX_QUEUES
   39 
   40 /* size of f/w command buffer */
   41 #define MALO_CMDBUF_SIZE                        0x4000
   42 
   43 #define MALO_FW_CHECK_USECS                     (5 * 1000)      /* 5ms */
   44 #define MALO_FW_MAX_NUM_CHECKS                  200  
   45 
   46 /*
   47  * Calibration data builtin to the firmware.  The firmware image
   48  * has a single set of calibration tables that we retrieve right
   49  * after download.  This can be overriden by the driver (e.g. for
   50  * a different regdomain and/or tx power setup).
   51  */
   52 struct malo_hal_caldata {
   53         /* pt is short for `power target'.  */
   54 #define MALO_PWTAGETRATETABLE20M                (14 * 4)
   55         uint8_t pt_ratetable_20m[MALO_PWTAGETRATETABLE20M];
   56 };
   57 
   58 /*
   59  * Get Hardware/Firmware capabilities.
   60  */
   61 struct malo_hal_hwspec {
   62         uint8_t         hwversion;              /* version of the HW */
   63         uint8_t         hostinterface;  /* host interface */
   64         uint16_t        maxnum_wcb;             /* max # of WCB FW handles */
   65         /* max # of mcast addresses FW handles*/
   66         uint16_t        maxnum_mcaddr;
   67         uint16_t        maxnum_tx_wcb;  /* max # of tx descs per WCB */
   68         /* MAC address programmed in HW */
   69         uint8_t         macaddr[6];
   70         uint16_t        regioncode;             /* EEPROM region code */
   71         uint16_t        num_antenna;    /* Number of antenna used */
   72         uint32_t        fw_releasenum;  /* firmware release number */
   73         uint32_t        wcbbase0;
   74         uint32_t        rxdesc_read;
   75         uint32_t        rxdesc_write;
   76         uint32_t        ul_fw_awakecookie;
   77         uint32_t        wcbbase[4];
   78 };
   79 
   80 /*
   81  * Supply tx/rx dma-related settings to the firmware.
   82  */
   83 struct malo_hal_txrxdma {
   84         uint32_t        maxnum_wcb;             /* max # of WCB FW handles */
   85         uint32_t        maxnum_txwcb;           /* max # of tx descs per WCB */
   86         uint32_t        rxdesc_read;
   87         uint32_t        rxdesc_write;
   88         uint32_t        wcbbase[4];
   89 };
   90 
   91 /*
   92  * Get Hardware Statistics.
   93  *
   94  * Items marked with ! are deprecated and not ever updated.  In
   95  * some cases this is because work has been moved to the host (e.g.
   96  * rx defragmentation).
   97  *
   98  * XXX low/up cases.
   99  */
  100 struct malo_hal_hwstats {
  101         uint32_t        TxRetrySuccesses;       /* tx success w/ 1 retry */
  102         uint32_t        TxMultipleRetrySuccesses;/* tx success w/ >1 retry */
  103         uint32_t        TxFailures;             /* tx fail due to no ACK */
  104         uint32_t        RTSSuccesses;           /* CTS rx'd for RTS */
  105         uint32_t        RTSFailures;            /* CTS not rx'd for RTS */
  106         uint32_t        AckFailures;            /* same as TxFailures */
  107         uint32_t        RxDuplicateFrames;      /* rx discard for dup seqno */
  108         uint32_t        FCSErrorCount;          /* rx discard for bad FCS */
  109         uint32_t        TxWatchDogTimeouts;     /* MAC tx hang (f/w recovery) */
  110         uint32_t        RxOverflows;            /* no f/w buffer for rx data */
  111         uint32_t        RxFragErrors;           /* !rx fail due to defrag */
  112         uint32_t        RxMemErrors;            /* out of mem or desc corrupted
  113                                                    in some way */
  114         uint32_t        RxPointerErrors;        /* MAC internal ptr problem */
  115         uint32_t        TxUnderflows;           /* !tx underflow on dma */
  116         uint32_t        TxDone;                 /* MAC tx ops completed
  117                                                    (possibly w/ error) */
  118         uint32_t        TxDoneBufTryPut;        /* ! */
  119         uint32_t        TxDoneBufPut;           /* same as TxDone */
  120         uint32_t        Wait4TxBuf;             /* !no f/w buf avail when
  121                                                     supplied a tx descriptor */
  122         uint32_t        TxAttempts;             /* tx descriptors processed */
  123         uint32_t        TxSuccesses;            /* tx attempts successful */ 
  124         uint32_t        TxFragments;            /* tx with fragmentation */
  125         uint32_t        TxMulticasts;           /* tx multicast frames */
  126         uint32_t        RxNonCtlPkts;           /* rx non-control frames */
  127         uint32_t        RxMulticasts;           /* rx multicast frames */
  128         uint32_t        RxUndecryptableFrames;  /* rx failed due to crypto */
  129         uint32_t        RxICVErrors;            /* rx failed due to ICV check */
  130         uint32_t        RxExcludedFrames;       /* rx discarded, e.g. bssid */
  131 };
  132 
  133 /*
  134  * Set Antenna Configuration (legacy operation).
  135  *
  136  * The RX antenna can be selected using the bitmask
  137  * ant (bit 0 = antenna 1, bit 1 = antenna 2, etc.)
  138  * (diversity?XXX)
  139  */
  140 enum malo_hal_antenna {
  141         MHA_ANTENNATYPE_RX      = 1,
  142         MHA_ANTENNATYPE_TX      = 2,
  143 };
  144 
  145 /*
  146  * Set Radio Configuration.
  147  *
  148  * onoff != 0 turns radio on; otherwise off.
  149  * if radio is enabled, the preamble is set too.
  150  */
  151 enum malo_hal_preamble {
  152         MHP_LONG_PREAMBLE       = 1,
  153         MHP_SHORT_PREAMBLE      = 3,
  154         MHP_AUTO_PREAMBLE       = 5,
  155 };
  156 
  157 struct malo_hal_channel_flags {
  158         uint32_t                freqband : 6,
  159 #define MALO_FREQ_BAND_2DOT4GHZ 0x1 
  160                                 : 26;           /* reserved */
  161 };
  162 
  163 struct malo_hal_channel {
  164         uint32_t                channel;
  165         struct malo_hal_channel_flags flags;
  166 };
  167 
  168 struct malo_hal_txrate {
  169         uint8_t                 mcastrate;      /* rate for multicast frames */
  170         uint8_t                 mgtrate;        /* rate for management frames */
  171         struct {
  172                 uint8_t         trycount;       /* try this many times */
  173                 uint8_t         rate;           /* use this tx rate */
  174         } rateseries[4];                        /* rate series */
  175 };
  176 
  177 struct malo_hal {
  178         device_t                mh_dev;
  179 
  180         bus_space_handle_t      mh_ioh;         /* BAR 1 copied from softc */
  181         bus_space_tag_t         mh_iot;
  182         uint32_t                mh_imask;       /* interrupt mask */
  183         int                     mh_flags;
  184 #define MHF_CALDATA             0x0001          /* cal data retrieved */
  185 #define MHF_FWHANG              0x0002          /* fw appears hung */
  186 
  187         char                    mh_mtxname[12];
  188         struct mtx              mh_mtx;
  189         bus_dma_tag_t           mh_dmat;        /* bus DMA tag for cmd buffer */
  190         bus_dmamap_t            mh_dmamap;      /* DMA map for cmd buffer */
  191         uint16_t                *mh_cmdbuf;     /* f/w cmd buffer */
  192         bus_addr_t              mh_cmdaddr;     /* physaddr of cmd buffer */
  193 
  194         struct malo_hal_caldata mh_caldata;
  195 
  196         int                     mh_debug;
  197 #define MALO_HAL_DEBUG_SENDCMD  0x00000001
  198 #define MALO_HAL_DEBUG_CMDDONE  0x00000002
  199 #define MALO_HAL_DEBUG_IGNHANG  0X00000004
  200 };
  201 
  202 #define MALO_HAL_LOCK(mh)               mtx_lock(&mh->mh_mtx)
  203 #define MALO_HAL_LOCK_ASSERT(mh)        mtx_assert(&mh->mh_mtx, MA_OWNED)
  204 #define MALO_HAL_UNLOCK(mh)             mtx_unlock(&mh->mh_mtx)
  205 
  206 struct malo_hal *malo_hal_attach(device_t, uint16_t,
  207             bus_space_handle_t, bus_space_tag_t,
  208             bus_dma_tag_t);
  209 int     malo_hal_fwload(struct malo_hal *, char *, char *);
  210 int     malo_hal_gethwspecs(struct malo_hal *,
  211             struct malo_hal_hwspec *);
  212 void    malo_hal_detach(struct malo_hal *);
  213 void    malo_hal_intrset(struct malo_hal *, uint32_t);
  214 int     malo_hal_setantenna(struct malo_hal *,
  215             enum malo_hal_antenna, int);
  216 int     malo_hal_setradio(struct malo_hal *, int,
  217             enum malo_hal_preamble);
  218 int     malo_hal_setchannel(struct malo_hal *,
  219             const struct malo_hal_channel *);
  220 int     malo_hal_setmaxtxpwr(struct malo_hal *, uint16_t);
  221 int     malo_hal_settxpower(struct malo_hal *, const struct malo_hal_channel *);
  222 int     malo_hal_setpromisc(struct malo_hal *, int);
  223 int     malo_hal_setassocid(struct malo_hal *,
  224             const uint8_t[], uint16_t);
  225 void    malo_hal_txstart(struct malo_hal *, int);
  226 void    malo_hal_getisr(struct malo_hal *, uint32_t *);
  227 void    malo_hal_cmddone(struct malo_hal *);
  228 int     malo_hal_prescan(struct malo_hal *);
  229 int     malo_hal_postscan(struct malo_hal *, uint8_t *, uint8_t);
  230 int     malo_hal_set_slot(struct malo_hal *, int);
  231 int     malo_hal_set_rate(struct malo_hal *, uint16_t, uint8_t);
  232 int     malo_hal_setmcast(struct malo_hal *, int, const uint8_t[]);
  233 
  234 #endif

Cache object: 327fc850e7f1a2031866faa6f3e9b7f5


[ source navigation ] [ diff markup ] [ identifier search ] [ freetext search ] [ file search ] [ list types ] [ track identifier ]


This page is part of the FreeBSD/Linux Linux Kernel Cross-Reference, and was automatically generated using a modified version of the LXR engine.