drivers/net/ni52.h

   1 /*
   2  * Intel i82586 Ethernet definitions
   3  *
   4  * This is an extension to the Linux operating system, and is covered by the
   5  * same GNU General Public License that covers that work.
   6  *
   7  * copyrights (c) 1994 by Michael Hipp (hippm@informatik.uni-tuebingen.de)
   8  *
   9  * I have done a look in the following sources:
  10  *   crynwr-packet-driver by Russ Nelson
  11  *   Garret A. Wollman's i82586-driver for BSD
  12  */
  13
  14
  15 #define NI52_RESET     0  /* writing to this address, resets the i82586 */
  16 #define NI52_ATTENTION 1  /* channel attention, kick the 586 */
  17 #define NI52_TENA      3  /* 2-5 possibly wrong, Xmit enable */
  18 #define NI52_TDIS      2  /* Xmit disable */
  19 #define NI52_INTENA    5  /* Interrupt enable */
  20 #define NI52_INTDIS    4  /* Interrupt disable */
  21 #define NI52_MAGIC1    6  /* dunno exact function */
  22 #define NI52_MAGIC2    7  /* dunno exact function */
  23
  24 #define NI52_MAGICVAL1 0x00  /* magic-values for ni5210 card */
  25 #define NI52_MAGICVAL2 0x55
  26
  27 /*
  28  * where to find the System Configuration Pointer (SCP)
  29  */
  30 #define SCP_DEFAULT_ADDRESS 0xfffff4
  31
  32
  33 /*
  34  * System Configuration Pointer Struct
  35  */
  36
  37 struct scp_struct
  38 {
  39         u16 zero_dum0;  /* has to be zero */
  40         u8 sysbus;      /* 0=16Bit,1=8Bit */
  41         u8 zero_dum1;   /* has to be zero for 586 */
  42         u16 zero_dum2;
  43         u16 zero_dum3;
  44         u32 iscp;               /* pointer to the iscp-block */
  45 };
  46
  47
  48 /*
  49  * Intermediate System Configuration Pointer (ISCP)
  50  */
  51 struct iscp_struct
  52 {
  53         u8 busy;          /* 586 clears after successful init */
  54         u8 zero_dummy;    /* has to be zero */
  55         u16 scb_offset;    /* pointeroffset to the scb_base */
  56         u32 scb_base;      /* base-address of all 16-bit offsets */
  57 };
  58
  59 /*
  60  * System Control Block (SCB)
  61  */
  62 struct scb_struct
  63 {
  64         u8 rus;
  65         u8 cus;
  66         u8 cmd_ruc;        /* command word: RU part */
  67         u8 cmd_cuc;        /* command word: CU part & ACK */
  68         u16 cbl_offset;    /* pointeroffset, command block list */
  69         u16 rfa_offset;    /* pointeroffset, receive frame area */
  70         u16 crc_errs;      /* CRC-Error counter */
  71         u16 aln_errs;      /* alignmenterror counter */
  72         u16 rsc_errs;      /* Resourceerror counter */
  73         u16 ovrn_errs;     /* OVerrunerror counter */
  74 };
  75
  76 /*
  77  * possible command values for the command word
  78  */
  79 #define RUC_MASK        0x0070  /* mask for RU commands */
  80 #define RUC_NOP         0x0000  /* NOP-command */
  81 #define RUC_START       0x0010  /* start RU */
  82 #define RUC_RESUME      0x0020  /* resume RU after suspend */
  83 #define RUC_SUSPEND     0x0030  /* suspend RU */
  84 #define RUC_ABORT       0x0040  /* abort receiver operation immediately */
  85
  86 #define CUC_MASK        0x07  /* mask for CU command */
  87 #define CUC_NOP         0x00  /* NOP-command */
  88 #define CUC_START       0x01  /* start execution of 1. cmd on the CBL */
  89 #define CUC_RESUME      0x02  /* resume after suspend */
  90 #define CUC_SUSPEND     0x03  /* Suspend CU */
  91 #define CUC_ABORT       0x04  /* abort command operation immediately */
  92
  93 #define ACK_MASK        0xf0  /* mask for ACK command */
  94 #define ACK_CX          0x80  /* acknowledges STAT_CX */
  95 #define ACK_FR          0x40  /* ack. STAT_FR */
  96 #define ACK_CNA         0x20  /* ack. STAT_CNA */
  97 #define ACK_RNR         0x10  /* ack. STAT_RNR */
  98
  99 /*
 100  * possible status values for the status word
 101  */
 102 #define STAT_MASK       0xf0  /* mask for cause of interrupt */
 103 #define STAT_CX         0x80  /* CU finished cmd with its I bit set */
 104 #define STAT_FR         0x40  /* RU finished receiving a frame */
 105 #define STAT_CNA        0x20  /* CU left active state */
 106 #define STAT_RNR        0x10  /* RU left ready state */
 107
 108 #define CU_STATUS       0x7   /* CU status, 0=idle */
 109 #define CU_SUSPEND      0x1   /* CU is suspended */
 110 #define CU_ACTIVE       0x2   /* CU is active */
 111
 112 #define RU_STATUS       0x70    /* RU status, 0=idle */
 113 #define RU_SUSPEND      0x10    /* RU suspended */
 114 #define RU_NOSPACE      0x20    /* RU no resources */
 115 #define RU_READY        0x40    /* RU is ready */
 116
 117 /*
 118  * Receive Frame Descriptor (RFD)
 119  */
 120 struct rfd_struct
 121 {
 122         u8  stat_low;   /* status word */
 123         u8  stat_high;  /* status word */
 124         u8  rfd_sf;     /* 82596 mode only */
 125         u8  last;               /* Bit15,Last Frame on List / Bit14,suspend */
 126         u16 next;               /* linkoffset to next RFD */
 127         u16 rbd_offset; /* pointeroffset to RBD-buffer */
 128         u8  dest[6];    /* ethernet-address, destination */
 129         u8  source[6];  /* ethernet-address, source */
 130         u16 length;     /* 802.3 frame-length */
 131         u16 zero_dummy; /* dummy */
 132 };
 133
 134 #define RFD_LAST     0x80       /* last: last rfd in the list */
 135 #define RFD_SUSP     0x40       /* last: suspend RU after  */
 136 #define RFD_COMPL    0x80
 137 #define RFD_OK       0x20
 138 #define RFD_BUSY     0x40
 139 #define RFD_ERR_LEN  0x10     /* Length error (if enabled length-checking */
 140 #define RFD_ERR_CRC  0x08     /* CRC error */
 141 #define RFD_ERR_ALGN 0x04     /* Alignment error */
 142 #define RFD_ERR_RNR  0x02     /* status: receiver out of resources */
 143 #define RFD_ERR_OVR  0x01     /* DMA Overrun! */
 144
 145 #define RFD_ERR_FTS  0x0080     /* Frame to short */
 146 #define RFD_ERR_NEOP 0x0040     /* No EOP flag (for bitstuffing only) */
 147 #define RFD_ERR_TRUN 0x0020     /* (82596 only/SF mode) indicates truncated frame */
 148 #define RFD_MATCHADD 0x0002     /* status: Destinationaddress !matches IA (only 82596) */
 149 #define RFD_COLLDET  0x0001     /* Detected collision during reception */
 150
 151 /*
 152  * Receive Buffer Descriptor (RBD)
 153  */
 154 struct rbd_struct
 155 {
 156         u16 status;     /* status word,number of used bytes in buff */
 157         u16 next;               /* pointeroffset to next RBD */
 158         u32 buffer;     /* receive buffer address pointer */
 159         u16 size;               /* size of this buffer */
 160         u16 zero_dummy;    /* dummy */
 161 };
 162
 163 #define RBD_LAST        0x8000  /* last buffer */
 164 #define RBD_USED        0x4000  /* this buffer has data */
 165 #define RBD_MASK        0x3fff  /* size-mask for length */
 166
 167 /*
 168  * Statusvalues for Commands/RFD
 169  */
 170 #define STAT_COMPL   0x8000     /* status: frame/command is complete */
 171 #define STAT_BUSY    0x4000     /* status: frame/command is busy */
 172 #define STAT_OK      0x2000     /* status: frame/command is ok */
 173
 174 /*
 175  * Action-Commands
 176  */
 177 #define CMD_NOP         0x0000  /* NOP */
 178 #define CMD_IASETUP     0x0001  /* initial address setup command */
 179 #define CMD_CONFIGURE   0x0002  /* configure command */
 180 #define CMD_MCSETUP     0x0003  /* MC setup command */
 181 #define CMD_XMIT        0x0004  /* transmit command */
 182 #define CMD_TDR         0x0005  /* time domain reflectometer (TDR) command */
 183 #define CMD_DUMP        0x0006  /* dump command */
 184 #define CMD_DIAGNOSE    0x0007  /* diagnose command */
 185
 186 /*
 187  * Action command bits
 188  */
 189 #define CMD_LAST        0x8000  /* indicates last command in the CBL */
 190 #define CMD_SUSPEND     0x4000  /* suspend CU after this CB */
 191 #define CMD_INT         0x2000  /* generate interrupt after execution */
 192
 193 /*
 194  * NOP - command
 195  */
 196 struct nop_cmd_struct
 197 {
 198         u16 cmd_status; /* status of this command */
 199         u16 cmd_cmd;       /* the command itself (+bits) */
 200         u16 cmd_link;      /* offsetpointer to next command */
 201 };
 202
 203 /*
 204  * IA Setup command
 205  */
 206 struct iasetup_cmd_struct
 207 {
 208         u16 cmd_status;
 209         u16 cmd_cmd;
 210         u16 cmd_link;
 211         u8  iaddr[6];
 212 };
 213
 214 /*
 215  * Configure command
 216  */
 217 struct configure_cmd_struct
 218 {
 219         u16 cmd_status;
 220         u16 cmd_cmd;
 221         u16 cmd_link;
 222         u8  byte_cnt;   /* size of the config-cmd */
 223         u8  fifo;       /* fifo/recv monitor */
 224         u8  sav_bf;     /* save bad frames (bit7=1)*/
 225         u8  adr_len;    /* adr_len(0-2),al_loc(3),pream(4-5),loopbak(6-7)*/
 226         u8  priority;   /* lin_prio(0-2),exp_prio(4-6),bof_metd(7) */
 227         u8  ifs;        /* inter frame spacing */
 228         u8  time_low;   /* slot time low */
 229         u8  time_high;  /* slot time high(0-2) and max. retries(4-7) */
 230         u8  promisc;    /* promisc-mode(0) , et al (1-7) */
 231         u8  carr_coll;  /* carrier(0-3)/collision(4-7) stuff */
 232         u8  fram_len;   /* minimal frame len */
 233         u8  dummy;           /* dummy */
 234 };
 235
 236 /*
 237  * Multicast Setup command
 238  */
 239 struct mcsetup_cmd_struct
 240 {
 241         u16 cmd_status;
 242         u16 cmd_cmd;
 243         u16 cmd_link;
 244         u16 mc_cnt;             /* number of bytes in the MC-List */
 245         u8  mc_list[0][6];      /* pointer to 6 bytes entries */
 246 };
 247
 248 /*
 249  * DUMP command
 250  */
 251 struct dump_cmd_struct
 252 {
 253         u16 cmd_status;
 254         u16 cmd_cmd;
 255         u16 cmd_link;
 256         u16 dump_offset;    /* pointeroffset to DUMP space */
 257 };
 258
 259 /*
 260  * transmit command
 261  */
 262 struct transmit_cmd_struct
 263 {
 264         u16 cmd_status;
 265         u16 cmd_cmd;
 266         u16 cmd_link;
 267         u16 tbd_offset; /* pointeroffset to TBD */
 268         u8  dest[6];       /* destination address of the frame */
 269         u16 length;     /* user defined: 802.3 length / Ether type */
 270 };
 271
 272 #define TCMD_ERRMASK     0x0fa0
 273 #define TCMD_MAXCOLLMASK 0x000f
 274 #define TCMD_MAXCOLL     0x0020
 275 #define TCMD_HEARTBEAT   0x0040
 276 #define TCMD_DEFERRED    0x0080
 277 #define TCMD_UNDERRUN    0x0100
 278 #define TCMD_LOSTCTS     0x0200
 279 #define TCMD_NOCARRIER   0x0400
 280 #define TCMD_LATECOLL    0x0800
 281
 282 struct tdr_cmd_struct
 283 {
 284         u16 cmd_status;
 285         u16 cmd_cmd;
 286         u16 cmd_link;
 287         u16 status;
 288 };
 289
 290 #define TDR_LNK_OK      0x8000  /* No link problem identified */
 291 #define TDR_XCVR_PRB    0x4000  /* indicates a transceiver problem */
 292 #define TDR_ET_OPN      0x2000  /* open, no correct termination */
 293 #define TDR_ET_SRT      0x1000  /* TDR detected a short circuit */
 294 #define TDR_TIMEMASK    0x07ff  /* mask for the time field */
 295
 296 /*
 297  * Transmit Buffer Descriptor (TBD)
 298  */
 299 struct tbd_struct
 300 {
 301         u16 size;               /* size + EOF-Flag(15) */
 302         u16 next;          /* pointeroffset to next TBD */
 303         u32 buffer;        /* pointer to buffer */
 304 };
 305
 306 #define TBD_LAST 0x8000         /* EOF-Flag, indicates last buffer in list */
 307
 308
 309
 310