sys/dev/netif/ndis/if_ndisvar.h

   1 /*-
   2  * Copyright (c) 2003
   3  *      Bill Paul <wpaul@windriver.com>.  All rights reserved.
   4  *
   5  * Redistribution and use in source and binary forms, with or without
   6  * modification, are permitted provided that the following conditions
   7  * are met:
   8  * 1. Redistributions of source code must retain the above copyright
   9  *    notice, this list of conditions and the following disclaimer.
  10  * 2. Redistributions in binary form must reproduce the above copyright
  11  *    notice, this list of conditions and the following disclaimer in the
  12  *    documentation and/or other materials provided with the distribution.
  13  * 3. All advertising materials mentioning features or use of this software
  14  *    must display the following acknowledgement:
  15  *      This product includes software developed by Bill Paul.
  16  * 4. Neither the name of the author nor the names of any co-contributors
  17  *    may be used to endorse or promote products derived from this software
  18  *    without specific prior written permission.
  19  *
  20  * THIS SOFTWARE IS PROVIDED BY Bill Paul AND CONTRIBUTORS ``AS IS'' AND
  21  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  22  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  23  * ARE DISCLAIMED.  IN NO EVENT SHALL Bill Paul OR THE VOICES IN HIS HEAD
  24  * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
  25  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
  26  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
  27  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
  28  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
  29  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF
  30  * THE POSSIBILITY OF SUCH DAMAGE.
  31  *
  32  * $FreeBSD: src/sys/dev/if_ndis/if_ndisvar.h,v 1.39 2009/05/02 15:14:18 thompsa Exp $
  33  */
  34
  35 #define NDIS_DEFAULT_NODENAME   "FreeBSD NDIS node"
  36 #define NDIS_NODENAME_LEN       32
  37
  38 /* For setting/getting OIDs from userspace. */
  39
  40 struct ndis_oid_data {
  41         uint32_t                oid;
  42         uint32_t                len;
  43 #ifdef notdef
  44         uint8_t                 data[1];
  45 #endif
  46 };
  47
  48 struct ndis_pci_type {
  49         uint16_t                ndis_vid;
  50         uint16_t                ndis_did;
  51         uint32_t                ndis_subsys;
  52         char                    *ndis_name;
  53 };
  54
  55 struct ndis_pccard_type {
  56         const char              *ndis_vid;
  57         const char              *ndis_did;
  58         char                    *ndis_name;
  59 };
  60
  61 struct ndis_usb_type {
  62         uint16_t                ndis_vid;
  63         uint16_t                ndis_did;
  64         char                    *ndis_name;
  65 };
  66
  67 struct ndis_shmem {
  68         list_entry              ndis_list;
  69         bus_dma_tag_t           ndis_stag;
  70         bus_dmamap_t            ndis_smap;
  71         void                    *ndis_saddr;
  72         ndis_physaddr           ndis_paddr;
  73 };
  74
  75 struct ndis_cfglist {
  76         ndis_cfg                ndis_cfg;
  77         struct sysctl_oid       *ndis_oid;
  78         TAILQ_ENTRY(ndis_cfglist)       link;
  79 };
  80
  81 /*
  82  * Helper struct to make parsing information
  83  * elements easier.
  84  */
  85 struct ndis_ie {
  86         uint8_t         ni_oui[3];
  87         uint8_t         ni_val;
  88 };
  89
  90 TAILQ_HEAD(nch, ndis_cfglist);
  91
  92 #define NDIS_INITIALIZED(sc)    (sc->ndis_block->nmb_devicectx != NULL)
  93
  94 #define NDIS_TXPKTS 64
  95 #define NDIS_INC(x)             \
  96         (x)->ndis_txidx = ((x)->ndis_txidx + 1) % (x)->ndis_maxpkts
  97
  98
  99 #define NDIS_EVENTS 4
 100 #define NDIS_EVTINC(x)  (x) = ((x) + 1) % NDIS_EVENTS
 101
 102 struct ndis_evt {
 103         uint32_t                ne_sts;
 104         uint32_t                ne_len;
 105         char                    *ne_buf;
 106 };
 107
 108 struct ndis_vap {
 109         struct ieee80211vap     vap;
 110
 111         int                     (*newstate)(struct ieee80211vap *,
 112                                     enum ieee80211_state, int);
 113 };
 114 #define NDIS_VAP(vap)   ((struct ndis_vap *)(vap))
 115
 116 #define NDISUSB_CONFIG_NO                       0
 117 #define NDISUSB_IFACE_INDEX                     0
 118 /* XXX at USB2 there's no USBD_NO_TIMEOUT macro anymore  */
 119 #define NDISUSB_NO_TIMEOUT                      0
 120 #define NDISUSB_INTR_TIMEOUT                    1000
 121 #define NDISUSB_TX_TIMEOUT                      10000
 122 struct ndisusb_xfer;
 123 struct ndisusb_ep {
 124         struct usb_xfer *ne_xfer[1];
 125         list_entry              ne_active;
 126         list_entry              ne_pending;
 127         kspin_lock              ne_lock;
 128         uint8_t                 ne_dirin;
 129 };
 130 struct ndisusb_xfer {
 131         struct ndisusb_ep       *nx_ep;
 132         void                    *nx_priv;
 133         uint8_t                 *nx_urbbuf;
 134         uint32_t                nx_urbactlen;
 135         uint32_t                nx_urblen;
 136         uint8_t                 nx_shortxfer;
 137         list_entry              nx_next;
 138 };
 139 struct ndisusb_xferdone {
 140         struct ndisusb_xfer     *nd_xfer;
 141         usb_error_t             nd_status;
 142         list_entry              nd_donelist;
 143 };
 144
 145 struct ndisusb_task {
 146         unsigned                nt_type;
 147 #define NDISUSB_TASK_TSTART     0
 148 #define NDISUSB_TASK_IRPCANCEL  1
 149 #define NDISUSB_TASK_VENDOR     2
 150         void                    *nt_ctx;
 151         list_entry              nt_tasklist;
 152 };
 153
 154 struct ndis_softc {
 155         struct ifnet            *ifp;
 156         struct ifmedia          ifmedia;        /* media info */
 157         u_long                  ndis_hwassist;
 158         uint32_t                ndis_v4tx;
 159         uint32_t                ndis_v4rx;
 160         bus_space_handle_t      ndis_bhandle;
 161         bus_space_tag_t         ndis_btag;
 162         void                    *ndis_intrhand;
 163         struct resource         *ndis_irq;
 164         struct resource         *ndis_res;
 165         struct resource         *ndis_res_io;
 166         int                     ndis_io_rid;
 167         struct resource         *ndis_res_mem;
 168         int                     ndis_mem_rid;
 169         struct resource         *ndis_res_altmem;
 170         int                     ndis_altmem_rid;
 171         struct resource         *ndis_res_am;   /* attribute mem (pccard) */
 172         int                     ndis_am_rid;
 173         struct resource         *ndis_res_cm;   /* common mem (pccard) */
 174         struct resource_list    ndis_rl;
 175         int                     ndis_rescnt;
 176         struct lock             ndis_lock;
 177         uint8_t                 ndis_irql;
 178         device_t                ndis_dev;
 179         int                     ndis_unit;
 180         ndis_miniport_block     *ndis_block;
 181         ndis_miniport_characteristics   *ndis_chars;
 182         interface_type          ndis_type;
 183         struct callout          ndis_scan_callout;
 184         struct callout          ndis_stat_callout;
 185         int                     ndis_maxpkts;
 186         ndis_oid                *ndis_oids;
 187         int                     ndis_oidcnt;
 188         int                     ndis_txidx;
 189         int                     ndis_txpending;
 190         ndis_packet             **ndis_txarray;
 191         ndis_handle             ndis_txpool;
 192         int                     ndis_sc;
 193         ndis_cfg                *ndis_regvals;
 194         struct nch              ndis_cfglist_head;
 195         int                     ndis_80211;
 196         int                     ndis_link;
 197         uint32_t                ndis_sts;
 198         uint32_t                ndis_filter;
 199         int                     ndis_if_flags;
 200         int                     ndis_skip;
 201
 202         struct sysctl_ctx_list  ndis_ctx;
 203         struct sysctl_oid       *ndis_tree;
 204         int                     ndis_devidx;
 205         interface_type          ndis_iftype;
 206         driver_object           *ndis_dobj;
 207         io_workitem             *ndis_tickitem;
 208         io_workitem             *ndis_startitem;
 209         io_workitem             *ndis_resetitem;
 210         io_workitem             *ndis_inputitem;
 211         kdpc                    ndis_rxdpc;
 212         bus_dma_tag_t           ndis_parent_tag;
 213         list_entry              ndis_shlist;
 214         bus_dma_tag_t           ndis_mtag;
 215         bus_dma_tag_t           ndis_ttag;
 216         bus_dmamap_t            *ndis_mmaps;
 217         bus_dmamap_t            *ndis_tmaps;
 218         int                     ndis_mmapcnt;
 219         struct ndis_evt         ndis_evt[NDIS_EVENTS];
 220         int                     ndis_evtpidx;
 221         int                     ndis_evtcidx;
 222         struct ifqueue          ndis_rxqueue;
 223         kspin_lock              ndis_rxlock;
 224
 225         int                     (*ndis_newstate)(struct ieee80211com *,
 226                                     enum ieee80211_state, int);
 227         int                     ndis_tx_timer;
 228         int                     ndis_hang_timer;
 229
 230         struct usb_device       *ndisusb_dev;
 231         struct lock             ndisusb_lock;
 232         struct ndisusb_ep       ndisusb_dread_ep;
 233         struct ndisusb_ep       ndisusb_dwrite_ep;
 234 #define NDISUSB_GET_ENDPT(addr) \
 235         ((UE_GET_DIR(addr) >> 7) | (UE_GET_ADDR(addr) << 1))
 236 #define NDISUSB_ENDPT_MAX       ((UE_ADDR + 1) * 2)
 237         struct ndisusb_ep       ndisusb_ep[NDISUSB_ENDPT_MAX];
 238         io_workitem             *ndisusb_xferdoneitem;
 239         list_entry              ndisusb_xferdonelist;
 240         kspin_lock              ndisusb_xferdonelock;
 241         io_workitem             *ndisusb_taskitem;
 242         list_entry              ndisusb_tasklist;
 243         kspin_lock              ndisusb_tasklock;
 244         int                     ndisusb_status;
 245 #define NDISUSB_STATUS_DETACH   0x1
 246 #define NDISUSB_STATUS_SETUP_EP 0x2
 247 };
 248
 249 #define NDIS_LOCK(_sc)          lockmgr(&(_sc)->ndis_lock, LK_EXCLUSIVE)
 250 #define NDIS_UNLOCK(_sc)        lockmgr(&(_sc)->ndis_lock, LK_RELEASE)
 251 #define NDISMTX_LOCK            NDIS_LOCK
 252 #define NDISMTX_UNLOCK          NDIS_UNLOCK
 253 #define NDIS_LOCK_ASSERT(_sc, t)        KKASSERT(lockstatus(&(_sc)->ndis_lock, curthread) != 0)
 254 #define NDISUSB_LOCK(_sc)       lockmgr(&(_sc)->ndisusb_lock, LK_EXCLUSIVE)
 255 #define NDISUSB_UNLOCK(_sc)     lockmgr(&(_sc)->ndisusb_lock, LK_RELEASE)
 256 #define NDISUSB_LOCK_ASSERT(_sc, t)     KKASSERT(lockstatus(&(_sc)->ndisusb_lock, curthread) != 0)