drivers/net/ethernet/natsemi/sonic.h

   1 /* SPDX-License-Identifier: GPL-2.0 */
   2 /*
   3  * Header file for sonic.c
   4  *
   5  * (C) Waldorf Electronics, Germany
   6  * Written by Andreas Busse
   7  *
   8  * NOTE: most of the structure definitions here are endian dependent.
   9  * If you want to use this driver on big endian machines, the data
  10  * and pad structure members must be exchanged. Also, the structures
  11  * need to be changed accordingly to the bus size.
  12  *
  13  * 981229 MSch: did just that for the 68k Mac port (32 bit, big endian)
  14  *
  15  * 990611 David Huggins-Daines <dhd@debian.org>: This machine abstraction
  16  * does not cope with 16-bit bus sizes very well.  Therefore I have
  17  * rewritten it with ugly macros and evil inlines.
  18  *
  19  * 050625 Finn Thain: introduced more 32-bit cards and dhd's support
  20  *        for 16-bit cards (from the mac68k project).
  21  */
  22
  23 #ifndef SONIC_H
  24 #define SONIC_H
  25
  26
  27 /*
  28  * SONIC register offsets
  29  */
  30
  31 #define SONIC_CMD              0x00
  32 #define SONIC_DCR              0x01
  33 #define SONIC_RCR              0x02
  34 #define SONIC_TCR              0x03
  35 #define SONIC_IMR              0x04
  36 #define SONIC_ISR              0x05
  37
  38 #define SONIC_UTDA             0x06
  39 #define SONIC_CTDA             0x07
  40
  41 #define SONIC_URDA             0x0d
  42 #define SONIC_CRDA             0x0e
  43 #define SONIC_EOBC             0x13
  44 #define SONIC_URRA             0x14
  45 #define SONIC_RSA              0x15
  46 #define SONIC_REA              0x16
  47 #define SONIC_RRP              0x17
  48 #define SONIC_RWP              0x18
  49 #define SONIC_RSC              0x2b
  50
  51 #define SONIC_CEP              0x21
  52 #define SONIC_CAP2             0x22
  53 #define SONIC_CAP1             0x23
  54 #define SONIC_CAP0             0x24
  55 #define SONIC_CE               0x25
  56 #define SONIC_CDP              0x26
  57 #define SONIC_CDC              0x27
  58
  59 #define SONIC_WT0              0x29
  60 #define SONIC_WT1              0x2a
  61
  62 #define SONIC_SR               0x28
  63
  64
  65 /* test-only registers */
  66
  67 #define SONIC_TPS               0x08
  68 #define SONIC_TFC               0x09
  69 #define SONIC_TSA0              0x0a
  70 #define SONIC_TSA1              0x0b
  71 #define SONIC_TFS               0x0c
  72
  73 #define SONIC_CRBA0             0x0f
  74 #define SONIC_CRBA1             0x10
  75 #define SONIC_RBWC0             0x11
  76 #define SONIC_RBWC1             0x12
  77 #define SONIC_TTDA              0x20
  78 #define SONIC_MDT               0x2f
  79
  80 #define SONIC_TRBA0             0x19
  81 #define SONIC_TRBA1             0x1a
  82 #define SONIC_TBWC0             0x1b
  83 #define SONIC_TBWC1             0x1c
  84 #define SONIC_LLFA              0x1f
  85
  86 #define SONIC_ADDR0             0x1d
  87 #define SONIC_ADDR1             0x1e
  88
  89 /*
  90  * Error counters
  91  */
  92
  93 #define SONIC_CRCT              0x2c
  94 #define SONIC_FAET              0x2d
  95 #define SONIC_MPT               0x2e
  96
  97 #define SONIC_DCR2              0x3f
  98
  99 /*
 100  * SONIC command bits
 101  */
 102
 103 #define SONIC_CR_LCAM           0x0200
 104 #define SONIC_CR_RRRA           0x0100
 105 #define SONIC_CR_RST            0x0080
 106 #define SONIC_CR_ST             0x0020
 107 #define SONIC_CR_STP            0x0010
 108 #define SONIC_CR_RXEN           0x0008
 109 #define SONIC_CR_RXDIS          0x0004
 110 #define SONIC_CR_TXP            0x0002
 111 #define SONIC_CR_HTX            0x0001
 112
 113 #define SONIC_CR_ALL (SONIC_CR_LCAM | SONIC_CR_RRRA | \
 114                       SONIC_CR_RXEN | SONIC_CR_TXP)
 115
 116 /*
 117  * SONIC data configuration bits
 118  */
 119
 120 #define SONIC_DCR_EXBUS         0x8000
 121 #define SONIC_DCR_LBR           0x2000
 122 #define SONIC_DCR_PO1           0x1000
 123 #define SONIC_DCR_PO0           0x0800
 124 #define SONIC_DCR_SBUS          0x0400
 125 #define SONIC_DCR_USR1          0x0200
 126 #define SONIC_DCR_USR0          0x0100
 127 #define SONIC_DCR_WC1           0x0080
 128 #define SONIC_DCR_WC0           0x0040
 129 #define SONIC_DCR_DW            0x0020
 130 #define SONIC_DCR_BMS           0x0010
 131 #define SONIC_DCR_RFT1          0x0008
 132 #define SONIC_DCR_RFT0          0x0004
 133 #define SONIC_DCR_TFT1          0x0002
 134 #define SONIC_DCR_TFT0          0x0001
 135
 136 /*
 137  * Constants for the SONIC receive control register.
 138  */
 139
 140 #define SONIC_RCR_ERR           0x8000
 141 #define SONIC_RCR_RNT           0x4000
 142 #define SONIC_RCR_BRD           0x2000
 143 #define SONIC_RCR_PRO           0x1000
 144 #define SONIC_RCR_AMC           0x0800
 145 #define SONIC_RCR_LB1           0x0400
 146 #define SONIC_RCR_LB0           0x0200
 147
 148 #define SONIC_RCR_MC            0x0100
 149 #define SONIC_RCR_BC            0x0080
 150 #define SONIC_RCR_LPKT          0x0040
 151 #define SONIC_RCR_CRS           0x0020
 152 #define SONIC_RCR_COL           0x0010
 153 #define SONIC_RCR_CRCR          0x0008
 154 #define SONIC_RCR_FAER          0x0004
 155 #define SONIC_RCR_LBK           0x0002
 156 #define SONIC_RCR_PRX           0x0001
 157
 158 #define SONIC_RCR_LB_OFF        0
 159 #define SONIC_RCR_LB_MAC        SONIC_RCR_LB0
 160 #define SONIC_RCR_LB_ENDEC      SONIC_RCR_LB1
 161 #define SONIC_RCR_LB_TRANS      (SONIC_RCR_LB0 | SONIC_RCR_LB1)
 162
 163 /* default RCR setup */
 164
 165 #define SONIC_RCR_DEFAULT       (SONIC_RCR_BRD)
 166
 167
 168 /*
 169  * SONIC Transmit Control register bits
 170  */
 171
 172 #define SONIC_TCR_PINTR         0x8000
 173 #define SONIC_TCR_POWC          0x4000
 174 #define SONIC_TCR_CRCI          0x2000
 175 #define SONIC_TCR_EXDIS         0x1000
 176 #define SONIC_TCR_EXD           0x0400
 177 #define SONIC_TCR_DEF           0x0200
 178 #define SONIC_TCR_NCRS          0x0100
 179 #define SONIC_TCR_CRLS          0x0080
 180 #define SONIC_TCR_EXC           0x0040
 181 #define SONIC_TCR_PMB           0x0008
 182 #define SONIC_TCR_FU            0x0004
 183 #define SONIC_TCR_BCM           0x0002
 184 #define SONIC_TCR_PTX           0x0001
 185
 186 #define SONIC_TCR_DEFAULT       0x0000
 187
 188 /*
 189  * Constants for the SONIC_INTERRUPT_MASK and
 190  * SONIC_INTERRUPT_STATUS registers.
 191  */
 192
 193 #define SONIC_INT_BR            0x4000
 194 #define SONIC_INT_HBL           0x2000
 195 #define SONIC_INT_LCD           0x1000
 196 #define SONIC_INT_PINT          0x0800
 197 #define SONIC_INT_PKTRX         0x0400
 198 #define SONIC_INT_TXDN          0x0200
 199 #define SONIC_INT_TXER          0x0100
 200 #define SONIC_INT_TC            0x0080
 201 #define SONIC_INT_RDE           0x0040
 202 #define SONIC_INT_RBE           0x0020
 203 #define SONIC_INT_RBAE          0x0010
 204 #define SONIC_INT_CRC           0x0008
 205 #define SONIC_INT_FAE           0x0004
 206 #define SONIC_INT_MP            0x0002
 207 #define SONIC_INT_RFO           0x0001
 208
 209
 210 /*
 211  * The interrupts we allow.
 212  */
 213
 214 #define SONIC_IMR_DEFAULT     ( SONIC_INT_BR | \
 215                                 SONIC_INT_LCD | \
 216                                 SONIC_INT_RFO | \
 217                                 SONIC_INT_PKTRX | \
 218                                 SONIC_INT_TXDN | \
 219                                 SONIC_INT_TXER | \
 220                                 SONIC_INT_RDE | \
 221                                 SONIC_INT_RBAE | \
 222                                 SONIC_INT_CRC | \
 223                                 SONIC_INT_FAE | \
 224                                 SONIC_INT_MP)
 225
 226
 227 #define SONIC_EOL       0x0001
 228 #define CAM_DESCRIPTORS 16
 229
 230 /* Offsets in the various DMA buffers accessed by the SONIC */
 231
 232 #define SONIC_BITMODE16 0
 233 #define SONIC_BITMODE32 1
 234 #define SONIC_BUS_SCALE(bitmode) ((bitmode) ? 4 : 2)
 235 /* Note!  These are all measured in bus-size units, so use SONIC_BUS_SCALE */
 236 #define SIZEOF_SONIC_RR 4
 237 #define SONIC_RR_BUFADR_L  0
 238 #define SONIC_RR_BUFADR_H  1
 239 #define SONIC_RR_BUFSIZE_L 2
 240 #define SONIC_RR_BUFSIZE_H 3
 241
 242 #define SIZEOF_SONIC_RD 7
 243 #define SONIC_RD_STATUS   0
 244 #define SONIC_RD_PKTLEN   1
 245 #define SONIC_RD_PKTPTR_L 2
 246 #define SONIC_RD_PKTPTR_H 3
 247 #define SONIC_RD_SEQNO    4
 248 #define SONIC_RD_LINK     5
 249 #define SONIC_RD_IN_USE   6
 250
 251 #define SIZEOF_SONIC_TD 8
 252 #define SONIC_TD_STATUS       0
 253 #define SONIC_TD_CONFIG       1
 254 #define SONIC_TD_PKTSIZE      2
 255 #define SONIC_TD_FRAG_COUNT   3
 256 #define SONIC_TD_FRAG_PTR_L   4
 257 #define SONIC_TD_FRAG_PTR_H   5
 258 #define SONIC_TD_FRAG_SIZE    6
 259 #define SONIC_TD_LINK         7
 260
 261 #define SIZEOF_SONIC_CD 4
 262 #define SONIC_CD_ENTRY_POINTER 0
 263 #define SONIC_CD_CAP0          1
 264 #define SONIC_CD_CAP1          2
 265 #define SONIC_CD_CAP2          3
 266
 267 #define SIZEOF_SONIC_CDA ((CAM_DESCRIPTORS * SIZEOF_SONIC_CD) + 1)
 268 #define SONIC_CDA_CAM_ENABLE   (CAM_DESCRIPTORS * SIZEOF_SONIC_CD)
 269
 270 /*
 271  * Some tunables for the buffer areas. Power of 2 is required
 272  * the current driver uses one receive buffer for each descriptor.
 273  *
 274  * MSch: use more buffer space for the slow m68k Macs!
 275  */
 276 #define SONIC_NUM_RRS   16            /* number of receive resources */
 277 #define SONIC_NUM_RDS   SONIC_NUM_RRS /* number of receive descriptors */
 278 #define SONIC_NUM_TDS   16            /* number of transmit descriptors */
 279
 280 #define SONIC_RRS_MASK  (SONIC_NUM_RRS - 1)
 281 #define SONIC_RDS_MASK  (SONIC_NUM_RDS - 1)
 282 #define SONIC_TDS_MASK  (SONIC_NUM_TDS - 1)
 283
 284 #define SONIC_RBSIZE    1520          /* size of one resource buffer */
 285
 286 /* Again, measured in bus size units! */
 287 #define SIZEOF_SONIC_DESC (SIZEOF_SONIC_CDA     \
 288         + (SIZEOF_SONIC_TD * SONIC_NUM_TDS)     \
 289         + (SIZEOF_SONIC_RD * SONIC_NUM_RDS)     \
 290         + (SIZEOF_SONIC_RR * SONIC_NUM_RRS))
 291
 292 /* Information that need to be kept for each board. */
 293 struct sonic_local {
 294         /* Bus size.  0 == 16 bits, 1 == 32 bits. */
 295         int dma_bitmode;
 296         /* Register offset within the longword (independent of endianness,
 297            and varies from one type of Macintosh SONIC to another
 298            (Aarrgh)) */
 299         int reg_offset;
 300         void *descriptors;
 301         /* Crud.  These areas have to be within the same 64K.  Therefore
 302        we allocate a desriptors page, and point these to places within it. */
 303         void *cda;  /* CAM descriptor area */
 304         void *tda;  /* Transmit descriptor area */
 305         void *rra;  /* Receive resource area */
 306         void *rda;  /* Receive descriptor area */
 307         struct sk_buff* volatile rx_skb[SONIC_NUM_RRS]; /* packets to be received */
 308         struct sk_buff* volatile tx_skb[SONIC_NUM_TDS]; /* packets to be transmitted */
 309         unsigned int tx_len[SONIC_NUM_TDS]; /* lengths of tx DMA mappings */
 310         /* Logical DMA addresses on MIPS, bus addresses on m68k
 311          * (so "laddr" is a bit misleading) */
 312         dma_addr_t descriptors_laddr;
 313         u32 cda_laddr;              /* logical DMA address of CDA */
 314         u32 tda_laddr;              /* logical DMA address of TDA */
 315         u32 rra_laddr;              /* logical DMA address of RRA */
 316         u32 rda_laddr;              /* logical DMA address of RDA */
 317         dma_addr_t rx_laddr[SONIC_NUM_RRS]; /* logical DMA addresses of rx skbuffs */
 318         dma_addr_t tx_laddr[SONIC_NUM_TDS]; /* logical DMA addresses of tx skbuffs */
 319         unsigned int rra_end;
 320         unsigned int cur_rwp;
 321         unsigned int cur_rx;
 322         unsigned int cur_tx;           /* first unacked transmit packet */
 323         unsigned int eol_rx;
 324         unsigned int eol_tx;           /* last unacked transmit packet */
 325         unsigned int next_tx;          /* next free TD */
 326         struct device *device;         /* generic device */
 327         struct net_device_stats stats;
 328         spinlock_t lock;
 329 };
 330
 331 #define TX_TIMEOUT (3 * HZ)
 332
 333 /* Index to functions, as function prototypes. */
 334
 335 static int sonic_open(struct net_device *dev);
 336 static int sonic_send_packet(struct sk_buff *skb, struct net_device *dev);
 337 static irqreturn_t sonic_interrupt(int irq, void *dev_id);
 338 static void sonic_rx(struct net_device *dev);
 339 static int sonic_close(struct net_device *dev);
 340 static struct net_device_stats *sonic_get_stats(struct net_device *dev);
 341 static void sonic_multicast_list(struct net_device *dev);
 342 static int sonic_init(struct net_device *dev);
 343 static void sonic_tx_timeout(struct net_device *dev);
 344
 345 /* Internal inlines for reading/writing DMA buffers.  Note that bus
 346    size and endianness matter here, whereas they don't for registers,
 347    as far as we can tell. */
 348 /* OpenBSD calls this "SWO".  I'd like to think that sonic_buf_put()
 349    is a much better name. */
 350 static inline void sonic_buf_put(u16 *base, int bitmode,
 351                                  int offset, __u16 val)
 352 {
 353         if (bitmode)
 354 #ifdef __BIG_ENDIAN
 355                 __raw_writew(val, base + (offset * 2) + 1);
 356 #else
 357                 __raw_writew(val, base + (offset * 2) + 0);
 358 #endif
 359         else
 360                 __raw_writew(val, base + (offset * 1) + 0);
 361 }
 362
 363 static inline __u16 sonic_buf_get(u16 *base, int bitmode,
 364                                   int offset)
 365 {
 366         if (bitmode)
 367 #ifdef __BIG_ENDIAN
 368                 return __raw_readw(base + (offset * 2) + 1);
 369 #else
 370                 return __raw_readw(base + (offset * 2) + 0);
 371 #endif
 372         else
 373                 return __raw_readw(base + (offset * 1) + 0);
 374 }
 375
 376 /* Inlines that you should actually use for reading/writing DMA buffers */
 377 static inline void sonic_cda_put(struct net_device* dev, int entry,
 378                                  int offset, __u16 val)
 379 {
 380         struct sonic_local *lp = netdev_priv(dev);
 381         sonic_buf_put(lp->cda, lp->dma_bitmode,
 382                       (entry * SIZEOF_SONIC_CD) + offset, val);
 383 }
 384
 385 static inline __u16 sonic_cda_get(struct net_device* dev, int entry,
 386                                   int offset)
 387 {
 388         struct sonic_local *lp = netdev_priv(dev);
 389         return sonic_buf_get(lp->cda, lp->dma_bitmode,
 390                              (entry * SIZEOF_SONIC_CD) + offset);
 391 }
 392
 393 static inline void sonic_set_cam_enable(struct net_device* dev, __u16 val)
 394 {
 395         struct sonic_local *lp = netdev_priv(dev);
 396         sonic_buf_put(lp->cda, lp->dma_bitmode, SONIC_CDA_CAM_ENABLE, val);
 397 }
 398
 399 static inline __u16 sonic_get_cam_enable(struct net_device* dev)
 400 {
 401         struct sonic_local *lp = netdev_priv(dev);
 402         return sonic_buf_get(lp->cda, lp->dma_bitmode, SONIC_CDA_CAM_ENABLE);
 403 }
 404
 405 static inline void sonic_tda_put(struct net_device* dev, int entry,
 406                                  int offset, __u16 val)
 407 {
 408         struct sonic_local *lp = netdev_priv(dev);
 409         sonic_buf_put(lp->tda, lp->dma_bitmode,
 410                       (entry * SIZEOF_SONIC_TD) + offset, val);
 411 }
 412
 413 static inline __u16 sonic_tda_get(struct net_device* dev, int entry,
 414                                   int offset)
 415 {
 416         struct sonic_local *lp = netdev_priv(dev);
 417         return sonic_buf_get(lp->tda, lp->dma_bitmode,
 418                              (entry * SIZEOF_SONIC_TD) + offset);
 419 }
 420
 421 static inline void sonic_rda_put(struct net_device* dev, int entry,
 422                                  int offset, __u16 val)
 423 {
 424         struct sonic_local *lp = netdev_priv(dev);
 425         sonic_buf_put(lp->rda, lp->dma_bitmode,
 426                       (entry * SIZEOF_SONIC_RD) + offset, val);
 427 }
 428
 429 static inline __u16 sonic_rda_get(struct net_device* dev, int entry,
 430                                   int offset)
 431 {
 432         struct sonic_local *lp = netdev_priv(dev);
 433         return sonic_buf_get(lp->rda, lp->dma_bitmode,
 434                              (entry * SIZEOF_SONIC_RD) + offset);
 435 }
 436
 437 static inline void sonic_rra_put(struct net_device* dev, int entry,
 438                                  int offset, __u16 val)
 439 {
 440         struct sonic_local *lp = netdev_priv(dev);
 441         sonic_buf_put(lp->rra, lp->dma_bitmode,
 442                       (entry * SIZEOF_SONIC_RR) + offset, val);
 443 }
 444
 445 static inline __u16 sonic_rra_get(struct net_device* dev, int entry,
 446                                   int offset)
 447 {
 448         struct sonic_local *lp = netdev_priv(dev);
 449         return sonic_buf_get(lp->rra, lp->dma_bitmode,
 450                              (entry * SIZEOF_SONIC_RR) + offset);
 451 }
 452
 453 static const char version[] =
 454     "sonic.c:v0.92 20.9.98 tsbogend@alpha.franken.de\n";
 455
 456 #endif /* SONIC_H */