1 /* $NetBSD: smc91cxxreg.h,v 1.6 2021/12/08 20:50:02 andvar Exp $ */ 2 3 /* 4 * Copyright (c) 1996 Gardner Buchanan <gbuchanan@shl.com> 5 * All rights reserved. 6 * 7 * Redistribution and use in source and binary forms, with or without 8 * modification, are permitted provided that the following conditions 9 * are met: 10 * 1. Redistributions of source code must retain the above copyright 11 * notice, this list of conditions and the following disclaimer. 12 * 2. Redistributions in binary form must reproduce the above copyright 13 * notice, this list of conditions and the following disclaimer in the 14 * documentation and/or other materials provided with the distribution. 15 * 3. All advertising materials mentioning features or use of this software 16 * must display the following acknowledgement: 17 * This product includes software developed by Gardner Buchanan. 18 * 4. The name of Gardner Buchanan may not be used to endorse or promote 19 * products derived from this software without specific prior written 20 * permission. 21 * 22 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR 23 * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES 24 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. 25 * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, 26 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT 27 * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 28 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 29 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 30 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF 31 * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 32 * 33 * from FreeBSD Id: if_snreg.h,v 1.4 1996/03/18 15:47:30 gardner Exp 34 */ 35 36 /* 37 * This file contains register information and access macros for 38 * the SMC91xxx chipset. 39 * 40 * Information contained in this file was obtained from the SMC91C92 41 * and SMC91C94 manuals from SMC. You will need one of these in order 42 * to make any meaningful changes to this driver. Information about 43 * obtaining one can be found at http://www.smc.com in the components 44 * division. 45 * 46 * This FreeBSD driver is derived in part from the smc9194 Linux driver 47 * by Erik Stahlman. 48 */ 49 50 51 /* 52 * Wait time for memory to be free. This probably shouldn't be 53 * tuned that much, as waiting for this means nothing else happens 54 * in the system 55 */ 56 #define MEMORY_WAIT_TIME 1000 57 58 59 /* The SMC91xxx uses 16 I/O ports */ 60 #define SMC_IOSIZE 16 61 62 63 /* 64 * A description of the SMC registers is probably in order here, 65 * although for details, the SMC datasheet is invaluable. 66 * The data sheet I (GB) am using is "SMC91C92 Single Chip Ethernet 67 * Controller With RAM", Rev. 12/0/94. Constant definitions I give 68 * here are loosely based on the mnemonic names given to them in the 69 * data sheet, but there are many exceptions. 70 * 71 * Basically, the chip has 4 banks of registers (0 to 3), which 72 * are accessed by writing a number into the BANK_SELECT register 73 * (I also use a SMC_SELECT_BANK macro for this). Registers are 74 * either Byte or Word sized. My constant definitions end in _B 75 * or _W as appropriate. 76 * 77 * The banks are arranged so that for most purposes, bank 2 is all 78 * that is needed for normal run time tasks. 79 */ 80 81 82 /* 83 * Bank Select Register. This also doubles as 84 * a chip identification register. This register 85 * is mapped at the same position in all banks. 86 */ 87 #define BANK_SELECT_REG_W 0x0e 88 #define BSR_DETECT_MASK 0xff00 89 #define BSR_DETECT_VALUE 0x3300 90 91 92 /* 93 * BANK 0 94 */ 95 96 /* 97 * Transmit Control Register controls some aspects of the transmit 98 * behavior of the Ethernet Protocol Handler. 99 */ 100 #define TXMIT_CONTROL_REG_W 0x00 101 102 #define TCR_ENABLE 0x0001 /* if this is 1, we can transmit */ 103 #define TCR_LOOP 0x0002 /* Enable internal analogue loopback */ 104 #define TCR_FORCOL 0x0004 /* Force Collision on next TX */ 105 #define TCR_PAD_ENABLE 0x0080 /* Pad short packets to 64 bytes */ 106 #define TCR_NOCRC 0x0100 /* Do not append CRC */ 107 #define TCR_MON_CSN 0x0400 /* monitors the carrier status */ 108 #define TCR_FDUPLX 0x0800 /* receive packets sent out */ 109 #define TCR_STP_SQET 0x1000 /* stop transmitting if Signal quality error */ 110 #define TCR_EPH_LOOP 0x2000 /* Enable internal digital loopback */ 111 #define TCR_SWFDUP 0x8000 /* FEAST: Switched full-duplex (only w/ MII) */ 112 113 114 /* 115 * Status of the last transmitted frame and instantaneous status of 116 * the Ethernet Protocol Handler jumbled together. In auto-release 117 * mode this information is simply discarded after each TX. This info 118 * is copied to the status word of in-memory packets after transmit 119 * where relevant statuses can be checked. 120 */ 121 #define EPH_STATUS_REG_W 0x02 122 123 #define EPHSR_TX_SUC 0x0001 /* Transmit was successful */ 124 #define EPHSR_SNGLCOL 0x0002 /* Single collision occurred */ 125 #define EPHSR_MULCOL 0x0004 /* Multiple Collisions occurred */ 126 #define EPHSR_LTX_MULT 0x0008 /* Transmit was a multicast */ 127 #define EPHSR_16COL 0x0010 /* 16 Collisions occurred, TX disabled */ 128 #define EPHSR_SQET 0x0020 /* SQE Test failed, TX disabled */ 129 #define EPHSR_LTX_BRD 0x0040 /* Transmit was a broadcast */ 130 #define EPHSR_DEFR 0x0080 /* TX deferred due to carrier det. */ 131 #define EPHSR_LATCOL 0x0200 /* Late collision detected, TX disabled */ 132 #define EPHSR_LOST_CAR 0x0400 /* Lost carrier sense, TX disabled */ 133 #define EPHSR_EXC_DEF 0x0800 /* Excessive deferrals in TX >2 MAXETHER 134 * times */ 135 #define EPHSR_CTR_ROL 0x1000 /* Some ECR Counter(s) rolled over */ 136 #define EPHSR_RX_OVRN 0x2000 /* Receiver overrun, packets dropped */ 137 #define EPHSR_LINK_OK 0x4000 /* Link integrity is OK */ 138 #define EPHSR_TXUNRN 0x8000 /* Transmit underrun */ 139 140 141 /* 142 * Receiver Control Register controls some aspects of the receive 143 * behavior of the Ethernet Protocol Handler. 144 */ 145 #define RECV_CONTROL_REG_W 0x04 146 147 #define RCR_RX_ABORT 0x0001 /* Received huge packet */ 148 #define RCR_PROMISC 0x0002 /* enable promiscuous mode */ 149 #define RCR_ALMUL 0x0004 /* receive all multicast packets */ 150 #define RCR_ENABLE 0x0100 /* IFF this is set, we can receive packets */ 151 #define RCR_STRIP_CRC 0x0200 /* strips CRC */ 152 #define RCR_GAIN_BITS 0x0c00 /* PLL Gain control (for testing) */ 153 #define RCR_FILT_CAR 0x4000 /* Enable 12 bit carrier filter */ 154 #define RCR_SOFTRESET 0x8000 /* Resets the EPH logic */ 155 156 157 /* 158 * TX Statistics counters 159 */ 160 #define COUNTER_REG_W 0x06 161 162 #define ECR_COLN_MASK 0x000f /* Vanilla collisions */ 163 #define ECR_MCOLN_MASK 0x00f0 /* Multiple collisions */ 164 #define ECR_DTX_MASK 0x0f00 /* Deferred transmits */ 165 #define ECR_EXDTX_MASK 0xf000 /* Excessively deferred transmits */ 166 167 168 /* 169 * Memory Information 170 */ 171 #define MEM_INFO_REG_W 0x08 172 173 #define MIR_FREE_MASK 0xff00 /* Free memory pages available */ 174 #define MIR_TOTAL_MASK 0x00ff /* Total memory pages available */ 175 #define MIR_MULT_91C111 1 176 #define MIR_SCALE_91C9x 256 177 #define MIR_SCALE_91C111 2048 178 179 180 /* 181 * Memory Configuration 182 */ 183 #define MEM_CFG_REG_W 0x0a 184 185 #define MCR_MEM_MULT(x) (((x)>>9)&7) /* Memory size multiplier */ 186 #define MCR_TXRSV_MASK 0x001f /* Count of pages reserved for transmit */ 187 188 /* 189 * Receive/PHY Control Register (SM91C111 only) 190 */ 191 #define RX_PHY_CONTROL_REG_W 0x0a /* 91C111 only */ 192 193 #define RPC_LSB_SHIFT 2 /* Shift for LED-B select bits */ 194 #define RPC_LSA_SHIFT 5 /* Shift for LED-A select bits */ 195 #define RPC_LS_MASK 0x7 /* LED Select mask */ 196 #define RPC_LS_LINK_DETECT 0x0 /* 10/100 link detected */ 197 #define RPC_LS_LINK_10MBPS 0x2 /* 10 MBPS link detected */ 198 #define RPC_LS_FULL_DUPLEX 0x3 /* Full duplex operation */ 199 #define RPC_LS_TXRX 0x4 /* Tx/Rx packet */ 200 #define RPC_LS_LINK_100MBPS 0x5 /* 100 MBPS link detected */ 201 #define RPC_LS_RX 0x6 /* Rx packet */ 202 #define RPC_LS_TX 0x7 /* Tx packet */ 203 #define RPC_ANEG 0x0800 /* Autonegotiate enable */ 204 #define RPC_DPLX 0x1000 /* Duplex select (set = Full) */ 205 #define RPC_SPEED 0x2000 /* Speed (set = 100mbps) */ 206 207 208 /* 209 * Bank 0, Register 0x0c is unused in the SMC91C92 210 */ 211 212 213 /* 214 * BANK 1 215 */ 216 217 /* 218 * Adapter configuration 219 */ 220 #define CONFIG_REG_W 0x00 221 222 #define CR_INT_SEL0 0x0002 /* Interrupt selector */ 223 #define CR_INT_SEL1 0x0004 /* Interrupt selector */ 224 #define CR_DIS_LINK 0x0040 /* Disable 10BaseT Link Test */ 225 #define CR_16BIT 0x0080 /* Bus width */ 226 #define CR_AUI_SELECT 0x0100 /* Use external (AUI) Transceiver */ 227 #define CR_SET_SQLCH 0x0200 /* Squelch level */ 228 #define CR_FULL_STEP 0x0400 /* AUI signalling mode */ 229 #define CR_NOW_WAIT_ST 0x1000 /* Disable bus wait states */ 230 #define CR_MII_SELECT 0x8000 /* FEAST: MII port selected */ 231 232 233 /* 234 * The contents of this port are used by the adapter 235 * to decode its I/O address. We use it as a verification 236 * that the adapter is detected properly when probing. 237 */ 238 #define BASE_ADDR_REG_W 0x02 /* The selected I/O Base addr. */ 239 240 241 /* 242 * These registers hold the Ethernet MAC address. 243 */ 244 #define IAR_ADDR0_REG_W 0x04 /* My Ethernet address */ 245 #define IAR_ADDR1_REG_W 0x06 /* My Ethernet address */ 246 #define IAR_ADDR2_REG_W 0x08 /* My Ethernet address */ 247 248 249 /* 250 * General purpose register used for talking to the EEPROM. 251 */ 252 #define GENERAL_REG_W 0x0a 253 254 255 /* 256 * Control register used for talking to the EEPROM and 257 * setting some EPH functions. 258 */ 259 #define CONTROL_REG_W 0x0c 260 261 #define CTR_STORE 0x0001 /* Store something to EEPROM */ 262 #define CTR_RELOAD 0x0002 /* Read EEPROM into registers */ 263 #define CTR_EEPROM_SEL 0x0004 /* Select registers for Reload/Store */ 264 #define CTR_TE_ENABLE 0x0020 /* Enable TX Error detection via EPH_INT */ 265 #define CTR_CR_ENABLE 0x0040 /* Enable Counter Rollover via EPH_INT */ 266 #define CTR_LE_ENABLE 0x0080 /* Enable Link Error detection via EPH_INT */ 267 #define CTR_AUTO_RELEASE 0x0800 /* Enable auto release mode for TX */ 268 #define CTR_POWERDOWN 0x2000 /* Enter powerdown mode */ 269 #define CTR_RCV_BAD 0x4000 /* Enable receipt of frames with bad CRC */ 270 271 272 /* 273 * BANK 2 274 */ 275 276 277 /* 278 * Memory Management Unit Control Register 279 * Controls allocation of memory to receive and 280 * transmit functions. 281 */ 282 #define MMU_CMD_REG_W 0x00 283 284 #define MMUCR_BUSY 0x0001 /* MMU busy performing a release */ 285 286 /* 287 * MMU Commands: 288 */ 289 #define MMUCR_NOP 0x0000 /* Do nothing */ 290 #define MMUCR_ALLOC 0x0020 /* Or with number of 256 byte packets - 1 */ 291 #define MMUCR_RESET 0x0040 /* Reset MMU State */ 292 #define MMUCR_REMOVE 0x0060 /* Dequeue (but not free) current RX packet */ 293 #define MMUCR_RELEASE 0x0080 /* Dequeue and free the current RX packet */ 294 #define MMUCR_FREEPKT 0x00a0 /* Release packet in PNR register */ 295 #define MMUCR_ENQUEUE 0x00c0 /* Enqueue the packet for transmit */ 296 #define MMUCR_RESETTX 0x00e0 /* Reset transmit queues */ 297 298 /* 299 * Packet Number at TX Area 300 */ 301 #define PACKET_NUM_REG_B 0x02 302 303 /* 304 * Packet number resulting from MMUCR_ALLOC 305 */ 306 #define ALLOC_RESULT_REG_B 0x03 307 #define ARR_FAILED 0x80 308 309 /* 310 * Transmit and receive queue heads 311 */ 312 #define FIFO_PORTS_REG_W 0x04 313 #define FIFO_REMPTY 0x8000 314 #define FIFO_TEMPTY 0x0080 315 #define FIFO_RX_MASK 0x7f00 316 #define FIFO_TX_MASK 0x007f 317 318 319 /* 320 * The address within the packet for reading/writing. The 321 * PTR_RCV bit is tricky. When PTR_RCV==1, the packet number 322 * to be read is found in the FIFO_PORTS_REG_W, FIFO_RX_MASK. 323 * When PTR_RCV==0, the packet number to be written is found 324 * in the PACKET_NUM_REG_B. 325 */ 326 #define POINTER_REG_W 0x06 327 328 #define PTR_READ 0x2000 /* Intended access mode */ 329 #define PTR_AUTOINC 0x4000 /* Do auto inc after read/write */ 330 #define PTR_RCV 0x8000 /* FIFO_RX is packet, otherwise PNR is packet */ 331 332 /* 333 * Data I/O register to be used in conjunction with 334 * The pointer register to read and write data from the 335 * card. The same register can be used for byte and word 336 * ops. 337 */ 338 #define DATA_REG_W 0x08 339 #define DATA_REG_B 0x08 340 #define DATA_1_REG_B 0x08 341 #define DATA_2_REG_B 0x0a 342 343 344 /* 345 * Sense interrupt status (READ) 346 */ 347 #define INTR_STAT_REG_B 0x0c 348 349 350 /* 351 * Acknowledge interrupt sources (WRITE) 352 */ 353 #define INTR_ACK_REG_B 0x0c 354 355 356 /* 357 * Interrupt mask. Bit set indicates interrupt allowed. 358 */ 359 #define INTR_MASK_REG_B 0x0d 360 361 /* 362 * Interrupts 363 */ 364 #define IM_RCV_INT 0x01 /* A packet has been received */ 365 #define IM_TX_INT 0x02 /* Packet TX complete */ 366 #define IM_TX_EMPTY_INT 0x04 /* No packets left to TX */ 367 #define IM_ALLOC_INT 0x08 /* Memory allocation completed */ 368 #define IM_RX_OVRN_INT 0x10 /* Receiver was overrun */ 369 #define IM_EPH_INT 0x20 /* Misc. EPH conditions (see CONTROL_REG_W) */ 370 #define IM_ERCV_INT 0x40 /* not on SMC9192 */ 371 #define IM_MD_INT 0x80 /* SMC91C111 Internal PHY status change */ 372 373 374 /* 375 * BANK 3 376 */ 377 378 379 /* 380 * Multicast subscriptions. 381 * The multicast handling in the SMC90Cxx is quite complicated. A table 382 * of multicast address subscriptions is provided and a clever way of 383 * speeding the search of that table by hashing is implemented in the 384 * hardware. I have ignored this and simply subscribed to all multicasts 385 * and let the kernel deal with the results. 386 */ 387 #define MULTICAST1_REG_W 0x00 388 #define MULTICAST2_REG_W 0x02 389 #define MULTICAST3_REG_W 0x04 390 #define MULTICAST4_REG_W 0x06 391 392 /* 393 * These registers do not exist on SMC9192, or at least 394 * are not documented in the SMC91C92 data sheet. 395 * 396 * The REVISION_REG_W register does however seem to work. 397 * 398 * On the FEAST, the low nibble controls the MII interface. 399 */ 400 #define MGMT_REG_W 0x08 401 402 #define MR_MDOE 0x08 403 #define MR_MCLK 0x04 404 #define MR_MDI 0x02 405 #define MR_MDO 0x01 406 407 #define REVISION_REG_W 0x0a /* (hi: chip id low: rev #) */ 408 #define RR_REV(x) ((x) & 0x0f) 409 #define RR_ID(x) (((x) >> 4) & 0x0f) 410 411 #define ERCV_REG_W 0x0c 412 413 /* 414 * These are constants expected to be found in the 415 * chip id register. 416 */ 417 #define CHIP_9190 3 418 #define CHIP_9194 4 419 #define CHIP_9195 5 420 #define CHIP_91100 7 421 #define CHIP_91100FD 8 422 #define CHIP_91C111 9 423 424 425 /* 426 * When packets are stuffed into the card or sucked out of the card 427 * they are set up more or less as follows: 428 * 429 * Addr msbyte lsbyte 430 * 00 SSSSSSSS SSSSSSSS - STATUS-WORD 16 bit TX or RX status 431 * 02 RRRRR - RESERVED (unused) 432 * 02 CCC CCCCCCCC - BYTE COUNT (RX: always even, TX: bit 0 ignored) 433 * 04 DDDDDDDD DDDDDDDD - DESTINATION ADDRESS 434 * 06 DDDDDDDD DDDDDDDD (48 bit Ethernet MAC Address) 435 * 08 DDDDDDDD DDDDDDDD 436 * 0A SSSSSSSS SSSSSSSS - SOURCE ADDRESS 437 * 0C SSSSSSSS SSSSSSSS (48 bit Ethernet MAC Address) 438 * 0E SSSSSSSS SSSSSSSS 439 * 10 PPPPPPPP PPPPPPPP 440 * .. PPPPPPPP PPPPPPPP 441 * C-2 CCCCCCCC - CONTROL BYTE 442 * C-2 PPPPPPPP - Last data byte (If odd length) 443 * 444 * The STATUS_WORD is derived from the EPH_STATUS_REG_W register 445 * during transmit and is composed of another set of bits described 446 * below during receive. 447 */ 448 449 450 /* 451 * Receive status bits. These values are found in the status word 452 * field of a received packet. For receive packets I use the RS_ODDFRAME 453 * to detect whether a frame has an extra byte on it. The CTLB_ODD 454 * bit of the control byte tells the same thing. 455 */ 456 #define RS_MULTICAST 0x0001 /* Packet is multicast */ 457 #define RS_HASH_MASK 0x007e /* Mask of multicast hash value */ 458 #define RS_TOOSHORT 0x0400 /* Frame was a runt, <64 bytes */ 459 #define RS_TOOLONG 0x0800 /* Frame was giant, >1518 */ 460 #define RS_ODDFRAME 0x1000 /* Frame is odd lengthed */ 461 #define RS_BADCRC 0x2000 /* Frame had CRC error */ 462 #define RS_ALGNERR 0x8000 /* Frame had alignment error */ 463 #define RS_ERRORS (RS_ALGNERR | RS_BADCRC | RS_TOOLONG | RS_TOOSHORT) 464 465 #define RLEN_MASK 0x07ff /* Significant length bits in RX length */ 466 467 /* 468 * The control byte has the following significant bits. 469 * For transmit, the CTLB_ODD bit specifies whether an extra byte 470 * is present in the frame. Bit 0 of the byte count field is 471 * ignored. I just pad every frame to even length and forget about 472 * it. 473 */ 474 #define CTLB_CRC 0x10 /* Add CRC for this packet (TX only) */ 475 #define CTLB_ODD 0x20 /* The packet length is ODD */ 476