/* SPDX-License-Identifier: GPL-2.0 */ 
 | 
/* 
 | 
 * Header file for sonic.c 
 | 
 * 
 | 
 * (C) Waldorf Electronics, Germany 
 | 
 * Written by Andreas Busse 
 | 
 * 
 | 
 * NOTE: most of the structure definitions here are endian dependent. 
 | 
 * If you want to use this driver on big endian machines, the data 
 | 
 * and pad structure members must be exchanged. Also, the structures 
 | 
 * need to be changed accordingly to the bus size. 
 | 
 * 
 | 
 * 981229 MSch:    did just that for the 68k Mac port (32 bit, big endian) 
 | 
 * 
 | 
 * 990611 David Huggins-Daines <dhd@debian.org>: This machine abstraction 
 | 
 * does not cope with 16-bit bus sizes very well.  Therefore I have 
 | 
 * rewritten it with ugly macros and evil inlines. 
 | 
 * 
 | 
 * 050625 Finn Thain: introduced more 32-bit cards and dhd's support 
 | 
 *        for 16-bit cards (from the mac68k project). 
 | 
 */ 
 | 
  
 | 
#ifndef SONIC_H 
 | 
#define SONIC_H 
 | 
  
 | 
  
 | 
/* 
 | 
 * SONIC register offsets 
 | 
 */ 
 | 
  
 | 
#define SONIC_CMD              0x00 
 | 
#define SONIC_DCR              0x01 
 | 
#define SONIC_RCR              0x02 
 | 
#define SONIC_TCR              0x03 
 | 
#define SONIC_IMR              0x04 
 | 
#define SONIC_ISR              0x05 
 | 
  
 | 
#define SONIC_UTDA             0x06 
 | 
#define SONIC_CTDA             0x07 
 | 
  
 | 
#define SONIC_URDA             0x0d 
 | 
#define SONIC_CRDA             0x0e 
 | 
#define SONIC_EOBC             0x13 
 | 
#define SONIC_URRA             0x14 
 | 
#define SONIC_RSA              0x15 
 | 
#define SONIC_REA              0x16 
 | 
#define SONIC_RRP              0x17 
 | 
#define SONIC_RWP              0x18 
 | 
#define SONIC_RSC              0x2b 
 | 
  
 | 
#define SONIC_CEP              0x21 
 | 
#define SONIC_CAP2             0x22 
 | 
#define SONIC_CAP1             0x23 
 | 
#define SONIC_CAP0             0x24 
 | 
#define SONIC_CE               0x25 
 | 
#define SONIC_CDP              0x26 
 | 
#define SONIC_CDC              0x27 
 | 
  
 | 
#define SONIC_WT0              0x29 
 | 
#define SONIC_WT1              0x2a 
 | 
  
 | 
#define SONIC_SR               0x28 
 | 
  
 | 
  
 | 
/* test-only registers */ 
 | 
  
 | 
#define SONIC_TPS        0x08 
 | 
#define SONIC_TFC        0x09 
 | 
#define SONIC_TSA0        0x0a 
 | 
#define SONIC_TSA1        0x0b 
 | 
#define SONIC_TFS        0x0c 
 | 
  
 | 
#define SONIC_CRBA0        0x0f 
 | 
#define SONIC_CRBA1        0x10 
 | 
#define SONIC_RBWC0        0x11 
 | 
#define SONIC_RBWC1        0x12 
 | 
#define SONIC_TTDA        0x20 
 | 
#define SONIC_MDT        0x2f 
 | 
  
 | 
#define SONIC_TRBA0        0x19 
 | 
#define SONIC_TRBA1        0x1a 
 | 
#define SONIC_TBWC0        0x1b 
 | 
#define SONIC_TBWC1        0x1c 
 | 
#define SONIC_LLFA        0x1f 
 | 
  
 | 
#define SONIC_ADDR0        0x1d 
 | 
#define SONIC_ADDR1        0x1e 
 | 
  
 | 
/* 
 | 
 * Error counters 
 | 
 */ 
 | 
  
 | 
#define SONIC_CRCT              0x2c 
 | 
#define SONIC_FAET              0x2d 
 | 
#define SONIC_MPT               0x2e 
 | 
  
 | 
#define SONIC_DCR2              0x3f 
 | 
  
 | 
/* 
 | 
 * SONIC command bits 
 | 
 */ 
 | 
  
 | 
#define SONIC_CR_LCAM           0x0200 
 | 
#define SONIC_CR_RRRA           0x0100 
 | 
#define SONIC_CR_RST            0x0080 
 | 
#define SONIC_CR_ST             0x0020 
 | 
#define SONIC_CR_STP            0x0010 
 | 
#define SONIC_CR_RXEN           0x0008 
 | 
#define SONIC_CR_RXDIS          0x0004 
 | 
#define SONIC_CR_TXP            0x0002 
 | 
#define SONIC_CR_HTX            0x0001 
 | 
  
 | 
#define SONIC_CR_ALL (SONIC_CR_LCAM | SONIC_CR_RRRA | \ 
 | 
              SONIC_CR_RXEN | SONIC_CR_TXP) 
 | 
  
 | 
/* 
 | 
 * SONIC data configuration bits 
 | 
 */ 
 | 
  
 | 
#define SONIC_DCR_EXBUS         0x8000 
 | 
#define SONIC_DCR_LBR           0x2000 
 | 
#define SONIC_DCR_PO1           0x1000 
 | 
#define SONIC_DCR_PO0           0x0800 
 | 
#define SONIC_DCR_SBUS          0x0400 
 | 
#define SONIC_DCR_USR1          0x0200 
 | 
#define SONIC_DCR_USR0          0x0100 
 | 
#define SONIC_DCR_WC1           0x0080 
 | 
#define SONIC_DCR_WC0           0x0040 
 | 
#define SONIC_DCR_DW            0x0020 
 | 
#define SONIC_DCR_BMS           0x0010 
 | 
#define SONIC_DCR_RFT1          0x0008 
 | 
#define SONIC_DCR_RFT0          0x0004 
 | 
#define SONIC_DCR_TFT1          0x0002 
 | 
#define SONIC_DCR_TFT0          0x0001 
 | 
  
 | 
/* 
 | 
 * Constants for the SONIC receive control register. 
 | 
 */ 
 | 
  
 | 
#define SONIC_RCR_ERR           0x8000 
 | 
#define SONIC_RCR_RNT           0x4000 
 | 
#define SONIC_RCR_BRD           0x2000 
 | 
#define SONIC_RCR_PRO           0x1000 
 | 
#define SONIC_RCR_AMC           0x0800 
 | 
#define SONIC_RCR_LB1           0x0400 
 | 
#define SONIC_RCR_LB0           0x0200 
 | 
  
 | 
#define SONIC_RCR_MC            0x0100 
 | 
#define SONIC_RCR_BC            0x0080 
 | 
#define SONIC_RCR_LPKT          0x0040 
 | 
#define SONIC_RCR_CRS           0x0020 
 | 
#define SONIC_RCR_COL           0x0010 
 | 
#define SONIC_RCR_CRCR          0x0008 
 | 
#define SONIC_RCR_FAER          0x0004 
 | 
#define SONIC_RCR_LBK           0x0002 
 | 
#define SONIC_RCR_PRX           0x0001 
 | 
  
 | 
#define SONIC_RCR_LB_OFF        0 
 | 
#define SONIC_RCR_LB_MAC        SONIC_RCR_LB0 
 | 
#define SONIC_RCR_LB_ENDEC      SONIC_RCR_LB1 
 | 
#define SONIC_RCR_LB_TRANS      (SONIC_RCR_LB0 | SONIC_RCR_LB1) 
 | 
  
 | 
/* default RCR setup */ 
 | 
  
 | 
#define SONIC_RCR_DEFAULT       (SONIC_RCR_BRD) 
 | 
  
 | 
  
 | 
/* 
 | 
 * SONIC Transmit Control register bits 
 | 
 */ 
 | 
  
 | 
#define SONIC_TCR_PINTR         0x8000 
 | 
#define SONIC_TCR_POWC          0x4000 
 | 
#define SONIC_TCR_CRCI          0x2000 
 | 
#define SONIC_TCR_EXDIS         0x1000 
 | 
#define SONIC_TCR_EXD           0x0400 
 | 
#define SONIC_TCR_DEF           0x0200 
 | 
#define SONIC_TCR_NCRS          0x0100 
 | 
#define SONIC_TCR_CRLS          0x0080 
 | 
#define SONIC_TCR_EXC           0x0040 
 | 
#define SONIC_TCR_OWC           0x0020 
 | 
#define SONIC_TCR_PMB           0x0008 
 | 
#define SONIC_TCR_FU            0x0004 
 | 
#define SONIC_TCR_BCM           0x0002 
 | 
#define SONIC_TCR_PTX           0x0001 
 | 
  
 | 
#define SONIC_TCR_DEFAULT       0x0000 
 | 
  
 | 
/* 
 | 
 * Constants for the SONIC_INTERRUPT_MASK and 
 | 
 * SONIC_INTERRUPT_STATUS registers. 
 | 
 */ 
 | 
  
 | 
#define SONIC_INT_BR        0x4000 
 | 
#define SONIC_INT_HBL        0x2000 
 | 
#define SONIC_INT_LCD        0x1000 
 | 
#define SONIC_INT_PINT        0x0800 
 | 
#define SONIC_INT_PKTRX        0x0400 
 | 
#define SONIC_INT_TXDN        0x0200 
 | 
#define SONIC_INT_TXER        0x0100 
 | 
#define SONIC_INT_TC        0x0080 
 | 
#define SONIC_INT_RDE        0x0040 
 | 
#define SONIC_INT_RBE        0x0020 
 | 
#define SONIC_INT_RBAE        0x0010 
 | 
#define SONIC_INT_CRC        0x0008 
 | 
#define SONIC_INT_FAE        0x0004 
 | 
#define SONIC_INT_MP        0x0002 
 | 
#define SONIC_INT_RFO        0x0001 
 | 
  
 | 
  
 | 
/* 
 | 
 * The interrupts we allow. 
 | 
 */ 
 | 
  
 | 
#define SONIC_IMR_DEFAULT     ( SONIC_INT_BR | \ 
 | 
                                SONIC_INT_LCD | \ 
 | 
                                SONIC_INT_RFO | \ 
 | 
                                SONIC_INT_PKTRX | \ 
 | 
                                SONIC_INT_TXDN | \ 
 | 
                                SONIC_INT_TXER | \ 
 | 
                                SONIC_INT_RDE | \ 
 | 
                                SONIC_INT_RBAE | \ 
 | 
                                SONIC_INT_CRC | \ 
 | 
                                SONIC_INT_FAE | \ 
 | 
                                SONIC_INT_MP) 
 | 
  
 | 
  
 | 
#define SONIC_EOL       0x0001 
 | 
#define CAM_DESCRIPTORS 16 
 | 
  
 | 
/* Offsets in the various DMA buffers accessed by the SONIC */ 
 | 
  
 | 
#define SONIC_BITMODE16 0 
 | 
#define SONIC_BITMODE32 1 
 | 
#define SONIC_BUS_SCALE(bitmode) ((bitmode) ? 4 : 2) 
 | 
/* Note!  These are all measured in bus-size units, so use SONIC_BUS_SCALE */ 
 | 
#define SIZEOF_SONIC_RR 4 
 | 
#define SONIC_RR_BUFADR_L  0 
 | 
#define SONIC_RR_BUFADR_H  1 
 | 
#define SONIC_RR_BUFSIZE_L 2 
 | 
#define SONIC_RR_BUFSIZE_H 3 
 | 
  
 | 
#define SIZEOF_SONIC_RD 7 
 | 
#define SONIC_RD_STATUS   0 
 | 
#define SONIC_RD_PKTLEN   1 
 | 
#define SONIC_RD_PKTPTR_L 2 
 | 
#define SONIC_RD_PKTPTR_H 3 
 | 
#define SONIC_RD_SEQNO    4 
 | 
#define SONIC_RD_LINK     5 
 | 
#define SONIC_RD_IN_USE   6 
 | 
  
 | 
#define SIZEOF_SONIC_TD 8 
 | 
#define SONIC_TD_STATUS       0 
 | 
#define SONIC_TD_CONFIG       1 
 | 
#define SONIC_TD_PKTSIZE      2 
 | 
#define SONIC_TD_FRAG_COUNT   3 
 | 
#define SONIC_TD_FRAG_PTR_L   4 
 | 
#define SONIC_TD_FRAG_PTR_H   5 
 | 
#define SONIC_TD_FRAG_SIZE    6 
 | 
#define SONIC_TD_LINK         7 
 | 
  
 | 
#define SIZEOF_SONIC_CD 4 
 | 
#define SONIC_CD_ENTRY_POINTER 0 
 | 
#define SONIC_CD_CAP0          1 
 | 
#define SONIC_CD_CAP1          2 
 | 
#define SONIC_CD_CAP2          3 
 | 
  
 | 
#define SIZEOF_SONIC_CDA ((CAM_DESCRIPTORS * SIZEOF_SONIC_CD) + 1) 
 | 
#define SONIC_CDA_CAM_ENABLE   (CAM_DESCRIPTORS * SIZEOF_SONIC_CD) 
 | 
  
 | 
/* 
 | 
 * Some tunables for the buffer areas. Power of 2 is required 
 | 
 * the current driver uses one receive buffer for each descriptor. 
 | 
 * 
 | 
 * MSch: use more buffer space for the slow m68k Macs! 
 | 
 */ 
 | 
#define SONIC_NUM_RRS   16            /* number of receive resources */ 
 | 
#define SONIC_NUM_RDS   SONIC_NUM_RRS /* number of receive descriptors */ 
 | 
#define SONIC_NUM_TDS   16            /* number of transmit descriptors */ 
 | 
  
 | 
#define SONIC_RRS_MASK  (SONIC_NUM_RRS - 1) 
 | 
#define SONIC_RDS_MASK  (SONIC_NUM_RDS - 1) 
 | 
#define SONIC_TDS_MASK  (SONIC_NUM_TDS - 1) 
 | 
  
 | 
#define SONIC_RBSIZE    1520          /* size of one resource buffer */ 
 | 
  
 | 
/* Again, measured in bus size units! */ 
 | 
#define SIZEOF_SONIC_DESC (SIZEOF_SONIC_CDA    \ 
 | 
    + (SIZEOF_SONIC_TD * SONIC_NUM_TDS)    \ 
 | 
    + (SIZEOF_SONIC_RD * SONIC_NUM_RDS)    \ 
 | 
    + (SIZEOF_SONIC_RR * SONIC_NUM_RRS)) 
 | 
  
 | 
/* Information that need to be kept for each board. */ 
 | 
struct sonic_local { 
 | 
    /* Bus size.  0 == 16 bits, 1 == 32 bits. */ 
 | 
    int dma_bitmode; 
 | 
    /* Register offset within the longword (independent of endianness, 
 | 
       and varies from one type of Macintosh SONIC to another 
 | 
       (Aarrgh)) */ 
 | 
    int reg_offset; 
 | 
    void *descriptors; 
 | 
    /* Crud.  These areas have to be within the same 64K.  Therefore 
 | 
       we allocate a desriptors page, and point these to places within it. */ 
 | 
    void *cda;  /* CAM descriptor area */ 
 | 
    void *tda;  /* Transmit descriptor area */ 
 | 
    void *rra;  /* Receive resource area */ 
 | 
    void *rda;  /* Receive descriptor area */ 
 | 
    struct sk_buff* volatile rx_skb[SONIC_NUM_RRS];    /* packets to be received */ 
 | 
    struct sk_buff* volatile tx_skb[SONIC_NUM_TDS];    /* packets to be transmitted */ 
 | 
    unsigned int tx_len[SONIC_NUM_TDS]; /* lengths of tx DMA mappings */ 
 | 
    /* Logical DMA addresses on MIPS, bus addresses on m68k 
 | 
     * (so "laddr" is a bit misleading) */ 
 | 
    dma_addr_t descriptors_laddr; 
 | 
    u32 cda_laddr;              /* logical DMA address of CDA */ 
 | 
    u32 tda_laddr;              /* logical DMA address of TDA */ 
 | 
    u32 rra_laddr;              /* logical DMA address of RRA */ 
 | 
    u32 rda_laddr;              /* logical DMA address of RDA */ 
 | 
    dma_addr_t rx_laddr[SONIC_NUM_RRS]; /* logical DMA addresses of rx skbuffs */ 
 | 
    dma_addr_t tx_laddr[SONIC_NUM_TDS]; /* logical DMA addresses of tx skbuffs */ 
 | 
    unsigned int cur_rx; 
 | 
    unsigned int cur_tx;           /* first unacked transmit packet */ 
 | 
    unsigned int eol_rx; 
 | 
    unsigned int eol_tx;           /* last unacked transmit packet */ 
 | 
    int msg_enable; 
 | 
    struct device *device;         /* generic device */ 
 | 
    struct net_device_stats stats; 
 | 
    spinlock_t lock; 
 | 
}; 
 | 
  
 | 
#define TX_TIMEOUT (3 * HZ) 
 | 
  
 | 
/* Index to functions, as function prototypes. */ 
 | 
  
 | 
static int sonic_open(struct net_device *dev); 
 | 
static int sonic_send_packet(struct sk_buff *skb, struct net_device *dev); 
 | 
static irqreturn_t sonic_interrupt(int irq, void *dev_id); 
 | 
static void sonic_rx(struct net_device *dev); 
 | 
static int sonic_close(struct net_device *dev); 
 | 
static struct net_device_stats *sonic_get_stats(struct net_device *dev); 
 | 
static void sonic_multicast_list(struct net_device *dev); 
 | 
static int sonic_init(struct net_device *dev, bool may_sleep); 
 | 
static void sonic_tx_timeout(struct net_device *dev, unsigned int txqueue); 
 | 
static void sonic_msg_init(struct net_device *dev); 
 | 
static int sonic_alloc_descriptors(struct net_device *dev); 
 | 
  
 | 
/* Internal inlines for reading/writing DMA buffers.  Note that bus 
 | 
   size and endianness matter here, whereas they don't for registers, 
 | 
   as far as we can tell. */ 
 | 
/* OpenBSD calls this "SWO".  I'd like to think that sonic_buf_put() 
 | 
   is a much better name. */ 
 | 
static inline void sonic_buf_put(u16 *base, int bitmode, 
 | 
                 int offset, __u16 val) 
 | 
{ 
 | 
    if (bitmode) 
 | 
#ifdef __BIG_ENDIAN 
 | 
        __raw_writew(val, base + (offset * 2) + 1); 
 | 
#else 
 | 
        __raw_writew(val, base + (offset * 2) + 0); 
 | 
#endif 
 | 
    else 
 | 
        __raw_writew(val, base + (offset * 1) + 0); 
 | 
} 
 | 
  
 | 
static inline __u16 sonic_buf_get(u16 *base, int bitmode, 
 | 
                  int offset) 
 | 
{ 
 | 
    if (bitmode) 
 | 
#ifdef __BIG_ENDIAN 
 | 
        return __raw_readw(base + (offset * 2) + 1); 
 | 
#else 
 | 
        return __raw_readw(base + (offset * 2) + 0); 
 | 
#endif 
 | 
    else 
 | 
        return __raw_readw(base + (offset * 1) + 0); 
 | 
} 
 | 
  
 | 
/* Inlines that you should actually use for reading/writing DMA buffers */ 
 | 
static inline void sonic_cda_put(struct net_device* dev, int entry, 
 | 
                 int offset, __u16 val) 
 | 
{ 
 | 
    struct sonic_local *lp = netdev_priv(dev); 
 | 
    sonic_buf_put(lp->cda, lp->dma_bitmode, 
 | 
              (entry * SIZEOF_SONIC_CD) + offset, val); 
 | 
} 
 | 
  
 | 
static inline __u16 sonic_cda_get(struct net_device* dev, int entry, 
 | 
                  int offset) 
 | 
{ 
 | 
    struct sonic_local *lp = netdev_priv(dev); 
 | 
    return sonic_buf_get(lp->cda, lp->dma_bitmode, 
 | 
                 (entry * SIZEOF_SONIC_CD) + offset); 
 | 
} 
 | 
  
 | 
static inline void sonic_set_cam_enable(struct net_device* dev, __u16 val) 
 | 
{ 
 | 
    struct sonic_local *lp = netdev_priv(dev); 
 | 
    sonic_buf_put(lp->cda, lp->dma_bitmode, SONIC_CDA_CAM_ENABLE, val); 
 | 
} 
 | 
  
 | 
static inline __u16 sonic_get_cam_enable(struct net_device* dev) 
 | 
{ 
 | 
    struct sonic_local *lp = netdev_priv(dev); 
 | 
    return sonic_buf_get(lp->cda, lp->dma_bitmode, SONIC_CDA_CAM_ENABLE); 
 | 
} 
 | 
  
 | 
static inline void sonic_tda_put(struct net_device* dev, int entry, 
 | 
                 int offset, __u16 val) 
 | 
{ 
 | 
    struct sonic_local *lp = netdev_priv(dev); 
 | 
    sonic_buf_put(lp->tda, lp->dma_bitmode, 
 | 
              (entry * SIZEOF_SONIC_TD) + offset, val); 
 | 
} 
 | 
  
 | 
static inline __u16 sonic_tda_get(struct net_device* dev, int entry, 
 | 
                  int offset) 
 | 
{ 
 | 
    struct sonic_local *lp = netdev_priv(dev); 
 | 
    return sonic_buf_get(lp->tda, lp->dma_bitmode, 
 | 
                 (entry * SIZEOF_SONIC_TD) + offset); 
 | 
} 
 | 
  
 | 
static inline void sonic_rda_put(struct net_device* dev, int entry, 
 | 
                 int offset, __u16 val) 
 | 
{ 
 | 
    struct sonic_local *lp = netdev_priv(dev); 
 | 
    sonic_buf_put(lp->rda, lp->dma_bitmode, 
 | 
              (entry * SIZEOF_SONIC_RD) + offset, val); 
 | 
} 
 | 
  
 | 
static inline __u16 sonic_rda_get(struct net_device* dev, int entry, 
 | 
                  int offset) 
 | 
{ 
 | 
    struct sonic_local *lp = netdev_priv(dev); 
 | 
    return sonic_buf_get(lp->rda, lp->dma_bitmode, 
 | 
                 (entry * SIZEOF_SONIC_RD) + offset); 
 | 
} 
 | 
  
 | 
static inline void sonic_rra_put(struct net_device* dev, int entry, 
 | 
                 int offset, __u16 val) 
 | 
{ 
 | 
    struct sonic_local *lp = netdev_priv(dev); 
 | 
    sonic_buf_put(lp->rra, lp->dma_bitmode, 
 | 
              (entry * SIZEOF_SONIC_RR) + offset, val); 
 | 
} 
 | 
  
 | 
static inline __u16 sonic_rra_get(struct net_device* dev, int entry, 
 | 
                  int offset) 
 | 
{ 
 | 
    struct sonic_local *lp = netdev_priv(dev); 
 | 
    return sonic_buf_get(lp->rra, lp->dma_bitmode, 
 | 
                 (entry * SIZEOF_SONIC_RR) + offset); 
 | 
} 
 | 
  
 | 
static inline u16 sonic_rr_addr(struct net_device *dev, int entry) 
 | 
{ 
 | 
    struct sonic_local *lp = netdev_priv(dev); 
 | 
  
 | 
    return lp->rra_laddr + 
 | 
           entry * SIZEOF_SONIC_RR * SONIC_BUS_SCALE(lp->dma_bitmode); 
 | 
} 
 | 
  
 | 
static inline u16 sonic_rr_entry(struct net_device *dev, u16 addr) 
 | 
{ 
 | 
    struct sonic_local *lp = netdev_priv(dev); 
 | 
  
 | 
    return (addr - (u16)lp->rra_laddr) / (SIZEOF_SONIC_RR * 
 | 
                          SONIC_BUS_SCALE(lp->dma_bitmode)); 
 | 
} 
 | 
  
 | 
static const char version[] = 
 | 
    "sonic.c:v0.92 20.9.98 tsbogend@alpha.franken.de\n"; 
 | 
  
 | 
#endif /* SONIC_H */ 
 |