Home | History | Annotate | Line # | Download | only in ic
      1 /*	$NetBSD: dp83932var.h,v 1.13 2021/02/20 09:36:31 rin Exp $	*/
      2 
      3 /*-
      4  * Copyright (c) 2001 The NetBSD Foundation, Inc.
      5  * All rights reserved.
      6  *
      7  * This code is derived from software contributed to The NetBSD Foundation
      8  * by Jason R. Thorpe.
      9  *
     10  * Redistribution and use in source and binary forms, with or without
     11  * modification, are permitted provided that the following conditions
     12  * are met:
     13  * 1. Redistributions of source code must retain the above copyright
     14  *    notice, this list of conditions and the following disclaimer.
     15  * 2. Redistributions in binary form must reproduce the above copyright
     16  *    notice, this list of conditions and the following disclaimer in the
     17  *    documentation and/or other materials provided with the distribution.
     18  *
     19  * THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
     20  * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
     21  * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
     22  * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
     23  * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
     24  * 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 IN
     27  * 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 THE
     29  * POSSIBILITY OF SUCH DAMAGE.
     30  */
     31 
     32 #ifndef _DEV_IC_DP83932VAR_H_
     33 #define	_DEV_IC_DP83932VAR_H_
     34 
     35 /*
     36  * Data structure definitions for the National Semiconductor DP83932
     37  * Systems-Oriented Network Interface Controller (SONIC).
     38  */
     39 
     40 /*
     41  * NOTE: The control data for the SONIC must not cross a 64k boundary,
     42  * so we have to be careful about how we size things.
     43  *
     44  * Also, since the SONIC is only a 10Mb/s chip, and systems on which
     45  * it is present tend to be low on memory, we try to keep the data
     46  * structure sizes small.
     47  */
     48 
     49 /*
     50  * Transmit descriptor list size.
     51  */
     52 #define	SONIC_NTXDESC		32
     53 #define	SONIC_NTXDESC_MASK	(SONIC_NTXDESC - 1)
     54 #define	SONIC_NEXTTX(x)		(((x) + 1) & SONIC_NTXDESC_MASK)
     55 
     56 /*
     57  * Receive descriptor list size.
     58  */
     59 #define	SONIC_NRXDESC		32
     60 #define	SONIC_NRXDESC_MASK	(SONIC_NRXDESC - 1)
     61 #define	SONIC_NEXTRX(x)		(((x) + 1) & SONIC_NRXDESC_MASK)
     62 #define	SONIC_PREVRX(x)		(((x) - 1) & SONIC_NRXDESC_MASK)
     63 #define	SONIC_RXSEQ_TO_DESC(x)	((x) & SONIC_NRXDESC_MASK)
     64 
     65 /*
     66  * Number of CAM entries.
     67  */
     68 #define	SONIC_NCAMENT		16
     69 
     70 /*
     71  * Control structures are DMA'd to the SONIC chip.  We allocate them in
     72  * a single clump that maps to a single DMA segment to make several things
     73  * easier.
     74  */
     75 struct sonic_control_data16 {
     76 	/*
     77 	 * The transmit descriptors.
     78 	 */
     79 	struct sonic_tda16 scd_txdescs[SONIC_NTXDESC];
     80 
     81 	/*
     82 	 * The receive descriptors.
     83 	 */
     84 	struct sonic_rda16 scd_rxdescs[SONIC_NRXDESC];
     85 
     86 	/*
     87 	 * The receive resource descriptors.
     88 	 */
     89 	struct sonic_rra16 scd_rxbufs[SONIC_NRXDESC];
     90 
     91 	/*
     92 	 * The CAM descriptors.
     93 	 */
     94 	struct sonic_cda16 scd_cam[SONIC_NCAMENT];
     95 	uint16_t scd_camenable;
     96 };
     97 
     98 #define	SONIC_CDOFF16(x)	offsetof(struct sonic_control_data16, x)
     99 #define	SONIC_CDTXOFF16(x)	SONIC_CDOFF16(scd_txdescs[(x)])
    100 #define	SONIC_CDRXOFF16(x)	SONIC_CDOFF16(scd_rxdescs[(x)])
    101 #define	SONIC_CDRROFF16(x)	SONIC_CDOFF16(scd_rxbufs[(x)])
    102 #define	SONIC_CDCAMOFF16	SONIC_CDOFF16(scd_cam)
    103 #define	SONIC_CDCAMSIZE16	\
    104 	(sizeof(struct sonic_cda16) * SONIC_NCAMENT + sizeof(uint16_t))
    105 
    106 struct sonic_control_data32 {
    107 	/*
    108 	 * The transmit descriptors.
    109 	 */
    110 	struct sonic_tda32 scd_txdescs[SONIC_NTXDESC];
    111 
    112 	/*
    113 	 * The receive descriptors.
    114 	 */
    115 	struct sonic_rda32 scd_rxdescs[SONIC_NRXDESC];
    116 
    117 	/*
    118 	 * The receive resource descriptors.
    119 	 */
    120 	struct sonic_rra32 scd_rxbufs[SONIC_NRXDESC];
    121 
    122 	/*
    123 	 * The CAM descriptors.
    124 	 */
    125 	struct sonic_cda32 scd_cam[SONIC_NCAMENT];
    126 	uint32_t scd_camenable;
    127 };
    128 
    129 #define	SONIC_CDOFF32(x)	offsetof(struct sonic_control_data32, x)
    130 #define	SONIC_CDTXOFF32(x)	SONIC_CDOFF32(scd_txdescs[(x)])
    131 #define	SONIC_CDRXOFF32(x)	SONIC_CDOFF32(scd_rxdescs[(x)])
    132 #define	SONIC_CDRROFF32(x)	SONIC_CDOFF32(scd_rxbufs[(x)])
    133 #define	SONIC_CDCAMOFF32	SONIC_CDOFF32(scd_cam)
    134 #define	SONIC_CDCAMSIZE32	\
    135 	(sizeof(struct sonic_cda32) * SONIC_NCAMENT + sizeof(uint32_t))
    136 
    137 /*
    138  * Software state for transmit and receive descriptors.
    139  */
    140 struct sonic_descsoft {
    141 	struct mbuf *ds_mbuf;		/* head of mbuf chain */
    142 	bus_dmamap_t ds_dmamap;		/* our DMA map */
    143 };
    144 
    145 /*
    146  * Software state per device.
    147  */
    148 struct sonic_softc {
    149 	device_t sc_dev;		/* generic device information */
    150 	bus_space_tag_t sc_st;		/* bus space tag */
    151 	bus_space_handle_t sc_sh;	/* bus space handle */
    152 	bus_dma_tag_t sc_dmat;		/* bus DMA tag */
    153 	struct ethercom sc_ethercom;	/* ethernet common data */
    154 
    155 	int sc_32bit;			/* use 32-bit mode */
    156 	int sc_bigendian;		/* BMODE -> Vcc */
    157 
    158 	/* Our register map. */
    159 	bus_addr_t sc_regmap[SONIC_NREGS];
    160 
    161 	bus_dmamap_t sc_cddmamap;	/* control data DMA map */
    162 #define	sc_cddma	sc_cddmamap->dm_segs[0].ds_addr
    163 	bus_dmamap_t sc_nulldmamap;	/* DMA map for the pad buffer */
    164 #define sc_nulldma     sc_nulldmamap->dm_segs[0].ds_addr
    165 
    166 	/*
    167 	 * Software state for transmit and receive descriptors.
    168 	 */
    169 	struct sonic_descsoft sc_txsoft[SONIC_NTXDESC];
    170 	struct sonic_descsoft sc_rxsoft[SONIC_NRXDESC];
    171 
    172 	/*
    173 	 * Control data structures.
    174 	 */
    175 	union {
    176 		struct sonic_control_data16 *cdun_16;
    177 		struct sonic_control_data32 *cdun_32;
    178 	} sc_cdun;
    179 #define	sc_cdata16	sc_cdun.cdun_16
    180 #define	sc_cdata32	sc_cdun.cdun_32
    181 
    182 #define	sc_tda16	sc_cdun.cdun_16->scd_txdescs
    183 #define	sc_rda16	sc_cdun.cdun_16->scd_rxdescs
    184 #define	sc_rra16	sc_cdun.cdun_16->scd_rxbufs
    185 #define	sc_cda16	sc_cdun.cdun_16->scd_cam
    186 #define	sc_cdaenable16	sc_cdun.cdun_16->scd_camenable
    187 
    188 #define	sc_tda32	sc_cdun.cdun_32->scd_txdescs
    189 #define	sc_rda32	sc_cdun.cdun_32->scd_rxdescs
    190 #define	sc_rra32	sc_cdun.cdun_32->scd_rxbufs
    191 #define	sc_cda32	sc_cdun.cdun_32->scd_cam
    192 #define	sc_cdaenable32	sc_cdun.cdun_32->scd_camenable
    193 
    194 	int	sc_txpending;		/* number of Tx requests pending */
    195 	int	sc_txdirty;		/* first dirty Tx descriptor */
    196 	int	sc_txlast;		/* last used Tx descriptor */
    197 
    198 	int	sc_rxptr;		/* next ready Rx descriptor */
    199 
    200 	uint16_t sc_imr;		/* prototype IMR */
    201 	uint16_t sc_dcr;		/* prototype DCR */
    202 	uint16_t sc_dcr2;		/* prototype DCR2 */
    203 
    204 	krndsource_t sc_rndsource;	/* random source */
    205 };
    206 
    207 #define	CSR_READ(sc, reg)						\
    208 	bus_space_read_2((sc)->sc_st, (sc)->sc_sh,			\
    209 	    (sc)->sc_regmap[(reg)])
    210 
    211 #define	CSR_WRITE(sc, reg, val)						\
    212 	bus_space_write_2((sc)->sc_st, (sc)->sc_sh,			\
    213 	    (sc)->sc_regmap[(reg)], (val))
    214 
    215 #define	SONIC_CDTXADDR16(sc, x)						\
    216 	((sc)->sc_cddma + SONIC_CDTXOFF16((x)))
    217 
    218 #define	SONIC_CDTXADDR32(sc, x)						\
    219 	((sc)->sc_cddma + SONIC_CDTXOFF32((x)))
    220 
    221 #define	SONIC_CDTXADDR(sc, x)						\
    222 	((sc)->sc_32bit ? SONIC_CDTXADDR32((sc), (x)) :			\
    223 	    SONIC_CDTXADDR16((sc), (x)))
    224 
    225 #define	SONIC_CDRXADDR16(sc, x)						\
    226 	((sc)->sc_cddma + SONIC_CDRXOFF16((x)))
    227 
    228 #define	SONIC_CDRXADDR32(sc, x)						\
    229 	((sc)->sc_cddma + SONIC_CDRXOFF32((x)))
    230 
    231 #define	SONIC_CDRXADDR(sc, x)						\
    232 	((sc)->sc_32bit ? SONIC_CDRXADDR32((sc), (x)) :			\
    233 	    SONIC_CDRXADDR16((sc), (x)))
    234 
    235 #define	SONIC_CDRRADDR(sc, x)						\
    236 	((sc)->sc_cddma +						\
    237 	 ((sc)->sc_32bit ? SONIC_CDRROFF32((x)) : SONIC_CDRROFF16((x))))
    238 
    239 #define	SONIC_CDCAMADDR(sc)						\
    240 	((sc)->sc_cddma +						\
    241 	 ((sc)->sc_32bit ? SONIC_CDCAMOFF32 : SONIC_CDCAMOFF16))
    242 
    243 #define	SONIC_CDTXSYNC16(sc, x, ops)					\
    244 	bus_dmamap_sync((sc)->sc_dmat, (sc)->sc_cddmamap,		\
    245 	    SONIC_CDTXOFF16((x)), sizeof(struct sonic_tda16), (ops))
    246 
    247 #define	SONIC_CDTXSYNC32(sc, x, ops)					\
    248 	bus_dmamap_sync((sc)->sc_dmat, (sc)->sc_cddmamap,		\
    249 	    SONIC_CDTXOFF32((x)), sizeof(struct sonic_tda32), (ops))
    250 
    251 #define	SONIC_CDRXSYNC16(sc, x, ops)					\
    252 	bus_dmamap_sync((sc)->sc_dmat, (sc)->sc_cddmamap,		\
    253 	    SONIC_CDRXOFF16((x)), sizeof(struct sonic_rda16), (ops))
    254 
    255 #define	SONIC_CDRXSYNC32(sc, x, ops)					\
    256 	bus_dmamap_sync((sc)->sc_dmat, (sc)->sc_cddmamap,		\
    257 	    SONIC_CDRXOFF32((x)), sizeof(struct sonic_rda32), (ops))
    258 
    259 #define	SONIC_CDRRSYNC16(sc, x, ops)					\
    260 	bus_dmamap_sync((sc)->sc_dmat, (sc)->sc_cddmamap,		\
    261 	    SONIC_CDRROFF16((x)), sizeof(struct sonic_rra16), (ops))
    262 
    263 #define	SONIC_CDRRSYNC32(sc, x, ops)					\
    264 	bus_dmamap_sync((sc)->sc_dmat, (sc)->sc_cddmamap,		\
    265 	    SONIC_CDRROFF32((x)), sizeof(struct sonic_rra32), (ops))
    266 
    267 #define	SONIC_CDCAMSYNC(sc, ops)					\
    268 do {									\
    269 	if ((sc)->sc_32bit)						\
    270 		bus_dmamap_sync((sc)->sc_dmat, (sc)->sc_cddmamap,	\
    271 		    SONIC_CDCAMOFF32, SONIC_CDCAMSIZE32,		\
    272 		    (ops));						\
    273 	else								\
    274 		bus_dmamap_sync((sc)->sc_dmat, (sc)->sc_cddmamap,	\
    275 		    SONIC_CDCAMOFF16, SONIC_CDCAMSIZE16,		\
    276 		    (ops));						\
    277 } while (/*CONSTCOND*/0)
    278 
    279 #define	SONIC_INIT_RXDESC(sc, x)					\
    280 do {									\
    281 	struct sonic_descsoft *__ds = &(sc)->sc_rxsoft[(x)];		\
    282 	struct mbuf *__m = __ds->ds_mbuf;				\
    283 									\
    284 	if ((sc)->sc_32bit) {						\
    285 		/*							\
    286 		 * Unfortuantely, in 32-bit mode, the Rx buffer must	\
    287 		 * be 32-bit aligned.					\
    288 		 */							\
    289 		struct sonic_rda32 *__rda = &(sc)->sc_rda32[(x)];	\
    290 		struct sonic_rda32 *__prda =				\
    291 		    &(sc)->sc_rda32[SONIC_PREVRX((x))];			\
    292 		struct sonic_rra32 *__rra = &(sc)->sc_rra32[(x)];	\
    293 									\
    294 		__m->m_data = __m->m_ext.ext_buf;			\
    295 									\
    296 		__rra->rra_ptr1 =					\
    297 		    __ds->ds_dmamap->dm_segs[0].ds_addr >> 16;		\
    298 		__rra->rra_ptr0 =					\
    299 		    __ds->ds_dmamap->dm_segs[0].ds_addr & 0xffff;	\
    300 		__rra->rra_wc1 = 0;					\
    301 		__rra->rra_wc0 = (ETHER_MAX_LEN + 6) / 2;		\
    302 									\
    303 		__rda->rda_link =					\
    304 		    (SONIC_CDRXADDR32((sc), SONIC_NEXTRX((x))) & 0xffff) |\
    305 		    RDA_LINK_EOL;					\
    306 		__rda->rda_inuse = 1;					\
    307 									\
    308 		__prda->rda_link = SONIC_CDRXADDR32((sc), (x));		\
    309 									\
    310 		SONIC_CDRRSYNC32((sc), (x), BUS_DMASYNC_PREWRITE);	\
    311 		SONIC_CDRXSYNC32((sc), (x),				\
    312 		    BUS_DMASYNC_PREREAD|BUS_DMASYNC_PREWRITE);		\
    313 		SONIC_CDRXSYNC32((sc), SONIC_PREVRX(x),			\
    314 		    BUS_DMASYNC_PREREAD|BUS_DMASYNC_PREWRITE);		\
    315 	} else {							\
    316 		/*							\
    317 		 * In 16-bit mode, we scoot the packet forward 2 bytes	\
    318 		 * so that the payload after the Ethernet header is	\
    319 		 * suitably aligned.					\
    320 		 */							\
    321 		struct sonic_rda16 *__rda = &(sc)->sc_rda16[(x)];	\
    322 		struct sonic_rda16 *__prda =				\
    323 		    &(sc)->sc_rda16[SONIC_PREVRX((x))];			\
    324 		struct sonic_rra16 *__rra = &(sc)->sc_rra16[(x)];	\
    325 									\
    326 		__m->m_data = __m->m_ext.ext_buf + 2;			\
    327 									\
    328 		__rra->rra_ptr1 =					\
    329 		    __ds->ds_dmamap->dm_segs[0].ds_addr >> 16;		\
    330 		__rra->rra_ptr0 =					\
    331 		    (__ds->ds_dmamap->dm_segs[0].ds_addr + 2) & 0xffff;	\
    332 		__rra->rra_wc1 = 0;					\
    333 		__rra->rra_wc0 = (ETHER_MAX_LEN + 2) / 2;		\
    334 									\
    335 		__rda->rda_link =					\
    336 		    (SONIC_CDRXADDR16((sc), SONIC_NEXTRX((x))) & 0xffff) |\
    337 		    RDA_LINK_EOL;					\
    338 		__rda->rda_inuse = 1;					\
    339 									\
    340 		__prda->rda_link = SONIC_CDRXADDR16((sc), (x));		\
    341 									\
    342 		SONIC_CDRRSYNC16((sc), (x), BUS_DMASYNC_PREWRITE);	\
    343 		SONIC_CDRXSYNC16((sc), (x),				\
    344 		    BUS_DMASYNC_PREREAD|BUS_DMASYNC_PREWRITE);		\
    345 		SONIC_CDRXSYNC16((sc), SONIC_PREVRX(x),			\
    346 		    BUS_DMASYNC_PREREAD|BUS_DMASYNC_PREWRITE);		\
    347 	}								\
    348 } while (/*CONSTCOND*/0)
    349 
    350 static __inline uint16_t __unused
    351 htosonic16(struct sonic_softc *sc, uint16_t val)
    352 {
    353 
    354 	if (sc->sc_bigendian)
    355 		return (htobe16(val));
    356 	return (htole16(val));
    357 }
    358 
    359 static __inline uint16_t __unused
    360 sonic16toh(struct sonic_softc *sc, uint16_t val)
    361 {
    362 
    363 	if (sc->sc_bigendian)
    364 		return (be16toh(val));
    365 	return (le16toh(val));
    366 }
    367 
    368 static __inline uint32_t __unused
    369 htosonic32(struct sonic_softc *sc, uint32_t val)
    370 {
    371 
    372 	if (sc->sc_bigendian)
    373 		return (htobe32(val));
    374 	return (htole32(val));
    375 }
    376 
    377 static __inline uint32_t __unused
    378 sonic32toh(struct sonic_softc *sc, uint32_t val)
    379 {
    380 
    381 	if (sc->sc_bigendian)
    382 		return (be32toh(val));
    383 	return (le32toh(val));
    384 }
    385 
    386 #ifdef _KERNEL
    387 void	sonic_attach(struct sonic_softc *, const uint8_t *);
    388 int	sonic_intr(void *);
    389 #endif /* _KERNEL */
    390 
    391 #endif /* _DEV_IC_DP83932VAR_H_ */
    392