/*      $NetBSD: bereg.h,v 1.10 2021/12/12 13:05:14 andvar Exp $        */

/*-
* Copyright (c) 1999 The NetBSD Foundation, Inc.
* All rights reserved.
*
* This code is derived from software contributed to The NetBSD Foundation
* by Paul Kranenburg.
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions
* are met:
* 1. Redistributions of source code must retain the above copyright
*    notice, this list of conditions and the following disclaimer.
* 2. Redistributions in binary form must reproduce the above copyright
*    notice, this list of conditions and the following disclaimer in the
*    documentation and/or other materials provided with the distribution.
*
* THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
* ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
* TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
* PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
* BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
* CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
* SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
* INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
* CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
* ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
* POSSIBILITY OF SUCH DAMAGE.
*/

/*
* Copyright (c) 1998 Theo de Raadt and Jason L. Wright.
* All rights reserved.
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions
* are met:
* 1. Redistributions of source code must retain the above copyright
*    notice, this list of conditions and the following disclaimer.
* 2. Redistributions in binary form must reproduce the above copyright
*    notice, this list of conditions and the following disclaimer in the
*    documentation and/or other materials provided with the distribution.
* 3. The name of the authors may not be used to endorse or promote products
*    derived from this software without specific prior written permission.
*
* THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS OR
* IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
* OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
* IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY DIRECT, INDIRECT,
* INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
* NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
* DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
* THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
* (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
* THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
*/

/*
* BE Global registers
*/
#if 0
struct be_bregs {
       uint32_t xif_cfg;               /* XIF config */
       uint32_t _unused[63];           /* reserved */
       uint32_t stat;                  /* status, clear on read */
       uint32_t imask;                 /* interrupt mask */
       uint32_t _unused2[64];          /* reserved */
       uint32_t tx_swreset;            /* tx software reset */
       uint32_t tx_cfg;                /* tx config */
       uint32_t ipkt_gap1;             /* inter-packet gap 1 */
       uint32_t ipkt_gap2;             /* inter-packet gap 2 */
       uint32_t attempt_limit;         /* tx attempt limit */
       uint32_t stime;                 /* tx slot time */
       uint32_t preamble_len;          /* size of tx preamble */
       uint32_t preamble_pattern;      /* pattern for tx preamble */
       uint32_t tx_sframe_delim;       /* tx delimiter */
       uint32_t jsize;                 /* jam length */
       uint32_t tx_pkt_max;            /* tx max pkt size */
       uint32_t tx_pkt_min;            /* tx min pkt size */
       uint32_t peak_attempt;          /* count of tx peak attempts */
       uint32_t dt_ctr;                /* tx defer timer */
       uint32_t nc_ctr;                /* tx normal collision cntr */
       uint32_t fc_ctr;                /* tx first-collision cntr */
       uint32_t ex_ctr;                /* tx excess-collision cntr */
       uint32_t lt_ctr;                /* tx late-collision cntr */
       uint32_t rand_seed;             /* tx random number seed */
       uint32_t tx_smachine;           /* tx state machine */
       uint32_t _unused3[44];          /* reserved */
       uint32_t rx_swreset;            /* rx software reset */
       uint32_t rx_cfg;                /* rx config register */
       uint32_t rx_pkt_max;            /* rx max pkt size */
       uint32_t rx_pkt_min;            /* rx min pkt size */
       uint32_t mac_addr2;             /* ethernet address 2 (MSB) */
       uint32_t mac_addr1;             /* ethernet address 1 */
       uint32_t mac_addr0;             /* ethernet address 0 (LSB) */
       uint32_t fr_ctr;                /* rx frame receive cntr */
       uint32_t gle_ctr;               /* rx giant-len error cntr */
       uint32_t unale_ctr;             /* rx unaligned error cntr */
       uint32_t rcrce_ctr;             /* rx CRC error cntr */
       uint32_t rx_smachine;           /* rx state machine */
       uint32_t rx_cvalid;             /* rx code violation */
       uint32_t _unused4;              /* reserved */
       uint32_t htable3;               /* hash table 3 */
       uint32_t htable2;               /* hash table 2 */
       uint32_t htable1;               /* hash table 1 */
       uint32_t htable0;               /* hash table 0 */
       uint32_t afilter2;              /* address filter 2 */
       uint32_t afilter1;              /* address filter 1 */
       uint32_t afilter0;              /* address filter 0 */
       uint32_t afilter_mask;          /* address filter mask */
};
#endif
/* register indices: */
#define BE_BRI_XIFCFG   (0*4)
#define BE_BRI_STAT     (64*4)
#define BE_BRI_IMASK    (65*4)
#define BE_BRI_TXCFG    (131*4)
#define BE_BRI_JSIZE    (139*4)
#define BE_BRI_TXMAX    (140*4)
#define BE_BRI_TXMIN    (141*4)
#define BE_BRI_NCCNT    (144*4)
#define BE_BRI_FCCNT    (145*4)
#define BE_BRI_EXCNT    (146*4)
#define BE_BRI_LTCNT    (147*4)
#define BE_BRI_RANDSEED (148*4)
#define BE_BRI_RXCFG    (195*4)
#define BE_BRI_RXMAX    (196*4)
#define BE_BRI_RXMIN    (197*4)
#define BE_BRI_MACADDR2 (198*4)
#define BE_BRI_MACADDR1 (199*4)
#define BE_BRI_MACADDR0 (200*4)
#define BE_BRI_HASHTAB3 (208*4)
#define BE_BRI_HASHTAB2 (209*4)
#define BE_BRI_HASHTAB1 (210*4)
#define BE_BRI_HASHTAB0 (211*4)

/* be_bregs.xif_cfg: XIF config. */
#define BE_BR_XCFG_ODENABLE     0x00000001      /* output driver enable */
#define BE_BR_XCFG_RESV         0x00000002      /* reserved, write as 1 */
#define BE_BR_XCFG_MLBACK       0x00000004      /* loopback-mode mii enable */
#define BE_BR_XCFG_SMODE        0x00000008      /* enable serial mode */

/* be_bregs.stat: status, clear on read. */
#define BE_BR_STAT_GOTFRAME     0x00000001      /* received a frame */
#define BE_BR_STAT_RCNTEXP      0x00000002      /* rx frame cntr expired */
#define BE_BR_STAT_ACNTEXP      0x00000004      /* align-error cntr expired */
#define BE_BR_STAT_CCNTEXP      0x00000008      /* crc-error cntr expired */
#define BE_BR_STAT_LCNTEXP      0x00000010      /* length-error cntr expired */
#define BE_BR_STAT_RFIFOVF      0x00000020      /* rx fifo overflow */
#define BE_BR_STAT_CVCNTEXP     0x00000040      /* code-violation cntr exprd */
#define BE_BR_STAT_SENTFRAME    0x00000100      /* transmitted a frame */
#define BE_BR_STAT_TFIFO_UND    0x00000200      /* tx fifo underrun */
#define BE_BR_STAT_MAXPKTERR    0x00000400      /* max-packet size error */
#define BE_BR_STAT_NCNTEXP      0x00000800      /* normal-collision cntr exp */
#define BE_BR_STAT_ECNTEXP      0x00001000      /* excess-collision cntr exp */
#define BE_BR_STAT_LCCNTEXP     0x00002000      /* late-collision cntr exp */
#define BE_BR_STAT_FCNTEXP      0x00004000      /* first-collision cntr exp */
#define BE_BR_STAT_DTIMEXP      0x00008000      /* defer-timer expired */
#define BE_BR_STAT_BITS         "\177\020"                              \
                       "b\0GOTFRAME\0b\1RCNTEXP\0b\2ACNTEXP\0"         \
                       "b\3CCNTEXP\0b\5LCNTEXP\0b\6RFIFOVF\0"          \
                       "b\7CVCNTEXP\0b\10SENTFRAME\0b\11TFIFO_UND\0"   \
                       "b\12MAXPKTERR\0b\13NCNTEXP\0b\14ECNTEXP\0"     \
                       "b\15LCCNTEXP\0b\16FCNTEXP\0b\17DTIMEXP\0\0"

/* be_bregs.imask: interrupt mask. */
#define BE_BR_IMASK_GOTFRAME    0x00000001      /* received a frame */
#define BE_BR_IMASK_RCNTEXP     0x00000002      /* rx frame cntr expired */
#define BE_BR_IMASK_ACNTEXP     0x00000004      /* align-error cntr expired */
#define BE_BR_IMASK_CCNTEXP     0x00000008      /* crc-error cntr expired */
#define BE_BR_IMASK_LCNTEXP     0x00000010      /* length-error cntr expired */
#define BE_BR_IMASK_RFIFOVF     0x00000020      /* rx fifo overflow */
#define BE_BR_IMASK_CVCNTEXP    0x00000040      /* code-violation cntr exprd */
#define BE_BR_IMASK_SENTFRAME   0x00000100      /* transmitted a frame */
#define BE_BR_IMASK_TFIFO_UND   0x00000200      /* tx fifo underrun */
#define BE_BR_IMASK_MAXPKTERR   0x00000400      /* max-packet size error */
#define BE_BR_IMASK_NCNTEXP     0x00000800      /* normal-collision cntr exp */
#define BE_BR_IMASK_ECNTEXP     0x00001000      /* excess-collision cntr exp */
#define BE_BR_IMASK_LCCNTEXP    0x00002000      /* late-collision cntr exp */
#define BE_BR_IMASK_FCNTEXP     0x00004000      /* first-collision cntr exp */
#define BE_BR_IMASK_DTIMEXP     0x00008000      /* defer-timer expired */

/* be_bregs.tx_cfg: tx config. */
#define BE_BR_TXCFG_ENABLE      0x00000001      /* enable the transmitter */
#define BE_BR_TXCFG_FIFO        0x00000010      /* default tx fthresh */
#define BE_BR_TXCFG_SMODE       0x00000020      /* enable slow transmit mode */
#define BE_BR_TXCFG_CIGN        0x00000040      /* ignore tx collisions */
#define BE_BR_TXCFG_FCSOFF      0x00000080      /* do not emit fcs */
#define BE_BR_TXCFG_DBACKOFF    0x00000100      /* disable backoff */
#define BE_BR_TXCFG_FULLDPLX    0x00000200      /* enable full-duplex */

/* be_bregs.rx_cfg: rx config. */
#define BE_BR_RXCFG_ENABLE      0x00000001      /* enable the receiver */
#define BE_BR_RXCFG_FIFO        0x0000000e      /* default rx fthresh */
#define BE_BR_RXCFG_PSTRIP      0x00000020      /* pad byte strip enable */
#define BE_BR_RXCFG_PMISC       0x00000040      /* enable promiscuous mode */
#define BE_BR_RXCFG_DERR        0x00000080      /* disable error checking */
#define BE_BR_RXCFG_DCRCS       0x00000100      /* disable crc stripping */
#define BE_BR_RXCFG_ME          0x00000200      /* receive packets for me */
#define BE_BR_RXCFG_PGRP        0x00000400      /* enable promisc group mode */
#define BE_BR_RXCFG_HENABLE     0x00000800      /* enable hash filter */
#define BE_BR_RXCFG_AENABLE     0x00001000      /* enable address filter */

/*
* BE Channel registers
*/
#if 0
struct be_cregs {
       uint32_t ctrl;          /* control */
       uint32_t stat;          /* status */
       uint32_t rxds;          /* rx descriptor ring ptr */
       uint32_t txds;          /* tx descriptor ring ptr */
       uint32_t rimask;        /* rx interrupt mask */
       uint32_t timask;        /* tx interrupt mask */
       uint32_t qmask;         /* qec error interrupt mask */
       uint32_t bmask;         /* be error interrupt mask */
       uint32_t rxwbufptr;     /* local memory rx write ptr */
       uint32_t rxrbufptr;     /* local memory rx read ptr */
       uint32_t txwbufptr;     /* local memory tx write ptr */
       uint32_t txrbufptr;     /* local memory tx read ptr */
       uint32_t ccnt;          /* collision counter */
};
#endif
/* register indices: */
#define BE_CRI_CTRL     (0*4)
#define BE_CRI_STAT     (1*4)
#define BE_CRI_RXDS     (2*4)
#define BE_CRI_TXDS     (3*4)
#define BE_CRI_RIMASK   (4*4)
#define BE_CRI_TIMASK   (5*4)
#define BE_CRI_QMASK    (6*4)
#define BE_CRI_BMASK    (7*4)
#define BE_CRI_RXWBUF   (8*4)
#define BE_CRI_RXRBUF   (9*4)
#define BE_CRI_TXWBUF   (10*4)
#define BE_CRI_TXRBUF   (11*4)
#define BE_CRI_CCNT     (12*4)

/* be_cregs.ctrl: control. */
#define BE_CR_CTRL_TWAKEUP      0x00000001      /* tx DMA wakeup */

/* be_cregs.stat: status. */
#define BE_CR_STAT_BERROR       0x80000000      /* be error */
#define BE_CR_STAT_TXIRQ        0x00200000      /* tx interrupt */
#define BE_CR_STAT_TXDERR       0x00080000      /* tx descriptor is bad */
#define BE_CR_STAT_TXLERR       0x00040000      /* tx late error */
#define BE_CR_STAT_TXPERR       0x00020000      /* tx parity error */
#define BE_CR_STAT_TXSERR       0x00010000      /* tx sbus error ack */
#define BE_CR_STAT_RXIRQ        0x00000020      /* rx interrupt */
#define BE_CR_STAT_RXDROP       0x00000010      /* rx packet dropped */
#define BE_CR_STAT_RXSMALL      0x00000008      /* rx buffer too small */
#define BE_CR_STAT_RXLERR       0x00000004      /* rx late error */
#define BE_CR_STAT_RXPERR       0x00000002      /* rx parity error */
#define BE_CR_STAT_RXSERR       0x00000001      /* rx sbus error ack */

/* be_cregs.qmask: qec error interrupt mask. */
#define BE_CR_QMASK_TXDERR      0x00080000      /* tx descriptor is bad */
#define BE_CR_QMASK_TXLERR      0x00040000      /* tx late error */
#define BE_CR_QMASK_TXPERR      0x00020000      /* tx parity error */
#define BE_CR_QMASK_TXSERR      0x00010000      /* tx sbus error ack */
#define BE_CR_QMASK_RXDROP      0x00000010      /* rx packet dropped */
#define BE_CR_QMASK_RXSMALL     0x00000008      /* rx buffer too small */
#define BE_CR_QMASK_RXLERR      0x00000004      /* rx late error */
#define BE_CR_QMASK_RXPERR      0x00000002      /* rx parity error */
#define BE_CR_QMASK_RXSERR      0x00000001      /* rx sbus error ack */

/*
* BE Transceiver registers
*/
#if 0
struct be_tregs {
       uint32_t        tcvr_pal;       /* transceiver pal */
       uint32_t        mgmt_pal;       /* management pal */
};
#endif
/* register indices: */
#define BE_TRI_TCVRPAL  0
#define BE_TRI_MGMTPAL  4

/* be_tregs.tcvr_pal: transceiver pal */
#define TCVR_PAL_SERIAL         0x00000001      /* serial mode enable */
#define TCVR_PAL_EXTLBACK       0x00000002      /* external loopback */
#define TCVR_PAL_MSENSE         0x00000004      /* media sense */
#define TCVR_PAL_LTENABLE       0x00000008      /* link test enable */
#define TCVR_PAL_LTSTATUS       0x00000010      /* link test status: p1 only */
#define TCVR_PAL_BITS           "\177\020"                              \
                               "b\0SERIAL\0b\1EXTLBACK\0b\2MSENSE\0"   \
                               "b\3LTENABLE\0\b4LTSTATUS\0\0"

/* be_tregs.mgmt_pal: management pal */
#define MGMT_PAL_DCLOCK         0x00000001      /* data clock strobe */
#define MGMT_PAL_OENAB          0x00000002      /* output enable */
#define MGMT_PAL_MDIO           0x00000004      /* MDIO data/attached */
#define MGMT_PAL_EXT_MDIO       MGMT_PAL_MDIO   /* external mdio */
#define MGMT_PAL_EXT_MDIO_SHIFT 2               /* position of ext mdio bit */
#define MGMT_PAL_TIMEO          0x00000008      /* tx enable timeout error */
#define MGMT_PAL_INT_MDIO       MGMT_PAL_TIMEO  /* internal mdio */
#define MGMT_PAL_INT_MDIO_SHIFT 3               /* position of int mdio bit */
#define MGMT_PAL_BITS           "\177\020"                              \
                               "b\0DLCLOCK\0b\1OENAB\0b\2EXT_MDIO\0"   \
                               "b\3INT_MDIO\0\0"

/* Packet buffer size */
#define BE_PKT_BUF_SZ           2048

#define MC_POLY_BE              0x04c11db7UL    /* mcast crc, big endian */
#define MC_POLY_LE              0xedb88320UL    /* mcast crc, little endian */

/* PHY addresses */
#define BE_PHY_EXTERNAL         0
#define BE_PHY_INTERNAL         1