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/tsec/if_tsec.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) 2006-2007 Semihalf, Piotr Kruszynski
    3  * 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  *
   14  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
   15  * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
   16  * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.  IN
   17  * NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
   18  * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED
   19  * TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
   20  * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
   21  * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
   22  * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
   23  * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
   24  *
   25  * $FreeBSD$
   26  */
   27 
   28 #ifndef _IF_TSEC_H
   29 #define _IF_TSEC_H
   30 
   31 #include <dev/ofw/openfirm.h>
   32 
   33 #define TSEC_RX_NUM_DESC        256
   34 #define TSEC_TX_NUM_DESC        256
   35 
   36 /* Interrupt Coalescing types */
   37 #define TSEC_IC_RX              0
   38 #define TSEC_IC_TX              1
   39 
   40 /* eTSEC ID */
   41 #define TSEC_ETSEC_ID           0x0124
   42 
   43 /* Frame sizes */
   44 #define TSEC_MIN_FRAME_SIZE     64
   45 #define TSEC_MAX_FRAME_SIZE     9600
   46 
   47 struct tsec_softc {
   48         /* XXX MII bus requires that struct ifnet is first!!! */
   49         struct ifnet    *tsec_ifp;
   50         
   51         struct mtx      transmit_lock;  /* transmitter lock */
   52         struct mtx      receive_lock;   /* receiver lock */
   53 
   54         phandle_t       node;
   55         device_t        dev;
   56         device_t        tsec_miibus;
   57         struct mii_data *tsec_mii;      /* MII media control */
   58         int             tsec_link;
   59 
   60         bus_dma_tag_t   tsec_tx_dtag;   /* TX descriptors tag */
   61         bus_dmamap_t    tsec_tx_dmap;   /* TX descriptors map */
   62         struct tsec_desc *tsec_tx_vaddr;/* vadress of TX descriptors */
   63         uint32_t        tsec_tx_raddr;  /* real adress of TX descriptors */
   64 
   65         bus_dma_tag_t   tsec_rx_dtag;   /* RX descriptors tag */
   66         bus_dmamap_t    tsec_rx_dmap;   /* RX descriptors map */
   67         struct tsec_desc *tsec_rx_vaddr; /* vadress of RX descriptors */
   68         uint32_t        tsec_rx_raddr;  /* real adress of RX descriptors */
   69 
   70         bus_dma_tag_t   tsec_tx_mtag;   /* TX mbufs tag */
   71         bus_dma_tag_t   tsec_rx_mtag;   /* TX mbufs tag */
   72 
   73         struct rx_data_type {
   74                 bus_dmamap_t    map;    /* mbuf map */
   75                 struct mbuf     *mbuf;
   76                 uint32_t        paddr;  /* DMA addres of buffer */
   77         } rx_data[TSEC_RX_NUM_DESC];
   78 
   79         uint32_t        tx_cur_desc_cnt;
   80         uint32_t        tx_dirty_desc_cnt;
   81         uint32_t        rx_cur_desc_cnt;
   82 
   83         struct resource *sc_rres;       /* register resource */
   84         int             sc_rrid;        /* register rid */
   85         struct {
   86                 bus_space_tag_t bst;
   87                 bus_space_handle_t bsh;
   88         } sc_bas;
   89 
   90         struct resource *sc_transmit_ires;
   91         void            *sc_transmit_ihand;
   92         int             sc_transmit_irid;
   93         struct resource *sc_receive_ires;
   94         void            *sc_receive_ihand;
   95         int             sc_receive_irid;
   96         struct resource *sc_error_ires;
   97         void            *sc_error_ihand;
   98         int             sc_error_irid;
   99 
  100         int             tsec_if_flags;
  101         int             is_etsec;
  102 
  103         /* Watchdog and MII tick related */
  104         struct callout  tsec_callout;
  105         int             tsec_watchdog;
  106 
  107         /* TX maps */
  108         bus_dmamap_t    tx_map_data[TSEC_TX_NUM_DESC];
  109 
  110         /* unused TX maps data */
  111         uint32_t        tx_map_unused_get_cnt;
  112         uint32_t        tx_map_unused_put_cnt;
  113         bus_dmamap_t    *tx_map_unused_data[TSEC_TX_NUM_DESC];
  114 
  115         /* used TX maps data */
  116         uint32_t        tx_map_used_get_cnt;
  117         uint32_t        tx_map_used_put_cnt;
  118         bus_dmamap_t    *tx_map_used_data[TSEC_TX_NUM_DESC];
  119         
  120         /* mbufs in TX queue */
  121         uint32_t        tx_mbuf_used_get_cnt;
  122         uint32_t        tx_mbuf_used_put_cnt;
  123         struct mbuf     *tx_mbuf_used_data[TSEC_TX_NUM_DESC];
  124 
  125         /* interrupt coalescing */
  126         struct mtx      ic_lock;
  127         uint32_t        rx_ic_time;     /* RW, valid values 0..65535 */
  128         uint32_t        rx_ic_count;    /* RW, valid values 0..255 */
  129         uint32_t        tx_ic_time;
  130         uint32_t        tx_ic_count;
  131 
  132         /* currently received frame */
  133         struct mbuf     *frame;
  134 
  135         int             phyaddr;
  136         struct tsec_softc *phy_sc;
  137 };
  138 
  139 /* interface to get/put generic objects */
  140 #define TSEC_CNT_INIT(cnt, wrap) ((cnt) = ((wrap) - 1))
  141 
  142 #define TSEC_INC(count, wrap) (count = ((count) + 1) & ((wrap) - 1))
  143 
  144 #define TSEC_GET_GENERIC(hand, tab, count, wrap) \
  145                 ((hand)->tab[TSEC_INC((hand)->count, wrap)])
  146 
  147 #define TSEC_PUT_GENERIC(hand, tab, count, wrap, val)   \
  148                 ((hand)->tab[TSEC_INC((hand)->count, wrap)] = val)
  149 
  150 #define TSEC_BACK_GENERIC(sc, count, wrap) do {                 \
  151                 if ((sc)->count > 0)                            \
  152                         (sc)->count--;                          \
  153                 else                                            \
  154                         (sc)->count = (wrap) - 1;               \
  155 } while (0)
  156 
  157 /* TX maps interface */
  158 #define TSEC_TX_MAP_CNT_INIT(sc) do {                                           \
  159                 TSEC_CNT_INIT((sc)->tx_map_unused_get_cnt, TSEC_TX_NUM_DESC);   \
  160                 TSEC_CNT_INIT((sc)->tx_map_unused_put_cnt, TSEC_TX_NUM_DESC);   \
  161                 TSEC_CNT_INIT((sc)->tx_map_used_get_cnt, TSEC_TX_NUM_DESC);     \
  162                 TSEC_CNT_INIT((sc)->tx_map_used_put_cnt, TSEC_TX_NUM_DESC);     \
  163 } while (0)
  164 
  165 /* interface to get/put unused TX maps */
  166 #define TSEC_ALLOC_TX_MAP(sc)                                                   \
  167                 TSEC_GET_GENERIC(sc, tx_map_unused_data, tx_map_unused_get_cnt, \
  168                 TSEC_TX_NUM_DESC)
  169 
  170 #define TSEC_FREE_TX_MAP(sc, val)                                               \
  171                 TSEC_PUT_GENERIC(sc, tx_map_unused_data, tx_map_unused_put_cnt, \
  172                 TSEC_TX_NUM_DESC, val)
  173 
  174 /* interface to get/put used TX maps */
  175 #define TSEC_GET_TX_MAP(sc)                                                     \
  176                 TSEC_GET_GENERIC(sc, tx_map_used_data, tx_map_used_get_cnt,     \
  177                 TSEC_TX_NUM_DESC)
  178 
  179 #define TSEC_PUT_TX_MAP(sc, val)                                                \
  180                 TSEC_PUT_GENERIC(sc, tx_map_used_data, tx_map_used_put_cnt,     \
  181                 TSEC_TX_NUM_DESC, val)
  182 
  183 /* interface to get/put TX mbufs in send queue */
  184 #define TSEC_TX_MBUF_CNT_INIT(sc) do {                                          \
  185                 TSEC_CNT_INIT((sc)->tx_mbuf_used_get_cnt, TSEC_TX_NUM_DESC);    \
  186                 TSEC_CNT_INIT((sc)->tx_mbuf_used_put_cnt, TSEC_TX_NUM_DESC);    \
  187 } while (0)
  188 
  189 #define TSEC_GET_TX_MBUF(sc)                                                    \
  190                 TSEC_GET_GENERIC(sc, tx_mbuf_used_data, tx_mbuf_used_get_cnt,   \
  191                 TSEC_TX_NUM_DESC)
  192 
  193 #define TSEC_PUT_TX_MBUF(sc, val)                                               \
  194                 TSEC_PUT_GENERIC(sc, tx_mbuf_used_data, tx_mbuf_used_put_cnt,   \
  195                 TSEC_TX_NUM_DESC, val)
  196 
  197 #define TSEC_EMPTYQ_TX_MBUF(sc) \
  198                 ((sc)->tx_mbuf_used_get_cnt == (sc)->tx_mbuf_used_put_cnt)
  199 
  200 /* interface for manage tx tsec_desc */
  201 #define TSEC_TX_DESC_CNT_INIT(sc) do {                                          \
  202                 TSEC_CNT_INIT((sc)->tx_cur_desc_cnt, TSEC_TX_NUM_DESC);         \
  203                 TSEC_CNT_INIT((sc)->tx_dirty_desc_cnt, TSEC_TX_NUM_DESC);       \
  204 } while (0)
  205 
  206 #define TSEC_GET_CUR_TX_DESC(sc)                                                \
  207                 &TSEC_GET_GENERIC(sc, tsec_tx_vaddr, tx_cur_desc_cnt,           \
  208                 TSEC_TX_NUM_DESC)
  209 
  210 #define TSEC_GET_DIRTY_TX_DESC(sc)                                              \
  211                 &TSEC_GET_GENERIC(sc, tsec_tx_vaddr, tx_dirty_desc_cnt,         \
  212                 TSEC_TX_NUM_DESC)
  213 
  214 #define TSEC_BACK_DIRTY_TX_DESC(sc) \
  215                 TSEC_BACK_GENERIC(sc, tx_dirty_desc_cnt, TSEC_TX_NUM_DESC)
  216 
  217 #define TSEC_CUR_DIFF_DIRTY_TX_DESC(sc) \
  218                 ((sc)->tx_cur_desc_cnt != (sc)->tx_dirty_desc_cnt)
  219 
  220 #define TSEC_FREE_TX_DESC(sc)                                           \
  221                 (((sc)->tx_cur_desc_cnt < (sc)->tx_dirty_desc_cnt) ?    \
  222                 ((sc)->tx_dirty_desc_cnt - (sc)->tx_cur_desc_cnt - 1)   \
  223                 :                                                       \
  224                 (TSEC_TX_NUM_DESC - (sc)->tx_cur_desc_cnt               \
  225                 + (sc)->tx_dirty_desc_cnt - 1))
  226 
  227 /* interface for manage rx tsec_desc */
  228 #define TSEC_RX_DESC_CNT_INIT(sc) do {                                  \
  229                 TSEC_CNT_INIT((sc)->rx_cur_desc_cnt, TSEC_RX_NUM_DESC); \
  230 } while (0)
  231 
  232 #define TSEC_GET_CUR_RX_DESC(sc)                                        \
  233                 &TSEC_GET_GENERIC(sc, tsec_rx_vaddr, rx_cur_desc_cnt,   \
  234                 TSEC_RX_NUM_DESC)
  235 
  236 #define TSEC_BACK_CUR_RX_DESC(sc) \
  237                 TSEC_BACK_GENERIC(sc, rx_cur_desc_cnt, TSEC_RX_NUM_DESC)
  238 
  239 #define TSEC_GET_CUR_RX_DESC_CNT(sc) \
  240                 ((sc)->rx_cur_desc_cnt)
  241 
  242 /* init all counters (for init only!) */
  243 #define TSEC_TX_RX_COUNTERS_INIT(sc) do {       \
  244                 TSEC_TX_MAP_CNT_INIT(sc);       \
  245                 TSEC_TX_MBUF_CNT_INIT(sc);      \
  246                 TSEC_TX_DESC_CNT_INIT(sc);      \
  247                 TSEC_RX_DESC_CNT_INIT(sc);      \
  248 } while (0)
  249 
  250 /* read/write bus functions */
  251 #define TSEC_READ(sc, reg)              \
  252                 bus_space_read_4((sc)->sc_bas.bst, (sc)->sc_bas.bsh, (reg))
  253 #define TSEC_WRITE(sc, reg, val)        \
  254                 bus_space_write_4((sc)->sc_bas.bst, (sc)->sc_bas.bsh, (reg), (val))
  255 
  256 /* Lock for transmitter */
  257 #define TSEC_TRANSMIT_LOCK(sc) do {                                     \
  258                 mtx_assert(&(sc)->receive_lock, MA_NOTOWNED);           \
  259                 mtx_lock(&(sc)->transmit_lock);                         \
  260 } while (0)
  261 
  262 #define TSEC_TRANSMIT_UNLOCK(sc)        mtx_unlock(&(sc)->transmit_lock)
  263 #define TSEC_TRANSMIT_LOCK_ASSERT(sc)   mtx_assert(&(sc)->transmit_lock, MA_OWNED)
  264 
  265 /* Lock for receiver */
  266 #define TSEC_RECEIVE_LOCK(sc) do {                                      \
  267                 mtx_assert(&(sc)->transmit_lock, MA_NOTOWNED);          \
  268                 mtx_lock(&(sc)->receive_lock);                          \
  269 } while (0)
  270 
  271 #define TSEC_RECEIVE_UNLOCK(sc)         mtx_unlock(&(sc)->receive_lock)
  272 #define TSEC_RECEIVE_LOCK_ASSERT(sc)    mtx_assert(&(sc)->receive_lock, MA_OWNED)
  273 
  274 /* Lock for interrupts coalescing */
  275 #define TSEC_IC_LOCK(sc) do {                                           \
  276                 mtx_assert(&(sc)->ic_lock, MA_NOTOWNED);                \
  277                 mtx_lock(&(sc)->ic_lock);                               \
  278 } while (0)
  279 
  280 #define TSEC_IC_UNLOCK(sc)              mtx_unlock(&(sc)->ic_lock)
  281 #define TSEC_IC_LOCK_ASSERT(sc)         mtx_assert(&(sc)->ic_lock, MA_OWNED)
  282 
  283 /* Global tsec lock (with all locks) */
  284 #define TSEC_GLOBAL_LOCK(sc) do {                                       \
  285                 if ((mtx_owned(&(sc)->transmit_lock) ? 1 : 0) !=        \
  286                         (mtx_owned(&(sc)->receive_lock) ? 1 : 0)) {     \
  287                         panic("tsec deadlock possibility detection!");  \
  288                 }                                                       \
  289                 mtx_lock(&(sc)->transmit_lock);                         \
  290                 mtx_lock(&(sc)->receive_lock);                          \
  291 } while (0)
  292 
  293 #define TSEC_GLOBAL_UNLOCK(sc) do {             \
  294                 TSEC_RECEIVE_UNLOCK(sc);        \
  295                 TSEC_TRANSMIT_UNLOCK(sc);       \
  296 } while (0)
  297 
  298 #define TSEC_GLOBAL_LOCK_ASSERT(sc) do {        \
  299                 TSEC_TRANSMIT_LOCK_ASSERT(sc);  \
  300                 TSEC_RECEIVE_LOCK_ASSERT(sc);   \
  301 } while (0)
  302 
  303 /* From global to {transmit,receive} */
  304 #define TSEC_GLOBAL_TO_TRANSMIT_LOCK(sc) do {   \
  305                 mtx_unlock(&(sc)->receive_lock);\
  306 } while (0)
  307 
  308 #define TSEC_GLOBAL_TO_RECEIVE_LOCK(sc) do {    \
  309                 mtx_unlock(&(sc)->transmit_lock);\
  310 } while (0)
  311 
  312 struct tsec_desc {
  313         volatile uint16_t       flags;  /* descriptor flags */
  314         volatile uint16_t       length; /* buffer length */
  315         volatile uint32_t       bufptr; /* buffer pointer */
  316 };
  317 
  318 #define TSEC_READ_RETRY 10000
  319 #define TSEC_READ_DELAY 100
  320 
  321 /* Structures and defines for TCP/IP Off-load */
  322 struct tsec_tx_fcb {
  323         volatile uint16_t       flags;
  324         volatile uint8_t        l4_offset;
  325         volatile uint8_t        l3_offset;
  326         volatile uint16_t       ph_chsum;
  327         volatile uint16_t       vlan;
  328 };
  329 
  330 struct tsec_rx_fcb {
  331         volatile uint16_t       flags;
  332         volatile uint8_t        rq_index;
  333         volatile uint8_t        protocol;
  334         volatile uint16_t       unused;
  335         volatile uint16_t       vlan;
  336 };
  337 
  338 #define TSEC_CHECKSUM_FEATURES  (CSUM_IP | CSUM_TCP | CSUM_UDP)
  339 
  340 #define TSEC_TX_FCB_IP4         TSEC_TX_FCB_L3_IS_IP
  341 #define TSEC_TX_FCB_IP6         (TSEC_TX_FCB_L3_IS_IP | TSEC_TX_FCB_L3_IS_IP6)
  342 
  343 #define TSEC_TX_FCB_TCP         TSEC_TX_FCB_L4_IS_TCP_UDP
  344 #define TSEC_TX_FCB_UDP         (TSEC_TX_FCB_L4_IS_TCP_UDP | TSEC_TX_FCB_L4_IS_UDP)
  345 
  346 #define TSEC_RX_FCB_IP_CSUM_CHECKED(flags)                                      \
  347                 ((flags & (TSEC_RX_FCB_IP_FOUND | TSEC_RX_FCB_IP6_FOUND |       \
  348                 TSEC_RX_FCB_IP_CSUM | TSEC_RX_FCB_PARSE_ERROR))                 \
  349                  == (TSEC_RX_FCB_IP_FOUND | TSEC_RX_FCB_IP_CSUM))
  350 
  351 #define TSEC_RX_FCB_TCP_UDP_CSUM_CHECKED(flags)                                 \
  352                 ((flags & (TSEC_RX_FCB_TCP_UDP_FOUND | TSEC_RX_FCB_TCP_UDP_CSUM \
  353                 | TSEC_RX_FCB_PARSE_ERROR))                                     \
  354                 == (TSEC_RX_FCB_TCP_UDP_FOUND | TSEC_RX_FCB_TCP_UDP_CSUM))
  355 
  356 /* Prototypes */
  357 extern devclass_t tsec_devclass;
  358 
  359 int     tsec_attach(struct tsec_softc *sc);
  360 int     tsec_detach(struct tsec_softc *sc);
  361 
  362 void    tsec_error_intr(void *arg);
  363 void    tsec_receive_intr(void *arg);
  364 void    tsec_transmit_intr(void *arg);
  365 
  366 int     tsec_miibus_readreg(device_t dev, int phy, int reg);
  367 int     tsec_miibus_writereg(device_t dev, int phy, int reg, int value);
  368 void    tsec_miibus_statchg(device_t dev);
  369 int     tsec_resume(device_t dev); /* XXX */
  370 int     tsec_shutdown(device_t dev);
  371 int     tsec_suspend(device_t dev); /* XXX */
  372 
  373 void    tsec_get_hwaddr(struct tsec_softc *sc, uint8_t *addr);
  374 
  375 #endif /* _IF_TSEC_H */

Cache object: f0dbd45dbd5e17be681e5670ace32174


[ 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.