drivers/net/typhoon.h

   1 /* typhoon.h:   chip info for the 3Com 3CR990 family of controllers */
   2 /*
   3         Written 2002-2003 by David Dillow <dave@thedillows.org>
   4
   5         This software may be used and distributed according to the terms of
   6         the GNU General Public License (GPL), incorporated herein by reference.
   7         Drivers based on or derived from this code fall under the GPL and must
   8         retain the authorship, copyright and license notice.  This file is not
   9         a complete program and may only be used when the entire operating
  10         system is licensed under the GPL.
  11
  12         This software is available on a public web site. It may enable
  13         cryptographic capabilities of the 3Com hardware, and may be
  14         exported from the United States under License Exception "TSU"
  15         pursuant to 15 C.F.R. Section 740.13(e).
  16
  17         This work was funded by the National Library of Medicine under
  18         the Department of Energy project number 0274DD06D1 and NLM project
  19         number Y1-LM-2015-01.
  20 */
  21
  22 /* All Typhoon ring positions are specificed in bytes, and point to the
  23  * first "clean" entry in the ring -- ie the next entry we use for whatever
  24  * purpose.
  25  */
  26
  27 /* The Typhoon basic ring
  28  * ringBase:  where this ring lives (our virtual address)
  29  * lastWrite: the next entry we'll use
  30  */
  31 struct basic_ring {
  32         u8 *ringBase;
  33         u32 lastWrite;
  34 };
  35
  36 /* The Typoon transmit ring -- same as a basic ring, plus:
  37  * lastRead:      where we're at in regard to cleaning up the ring
  38  * writeRegister: register to use for writing (different for Hi & Lo rings)
  39  */
  40 struct transmit_ring {
  41         u8 *ringBase;
  42         u32 lastWrite;
  43         u32 lastRead;
  44         int writeRegister;
  45 };
  46
  47 /* The host<->Typhoon ring index structure
  48  * This indicates the current positions in the rings
  49  *
  50  * All values must be in little endian format for the 3XP
  51  *
  52  * rxHiCleared:   entry we've cleared to in the Hi receive ring
  53  * rxLoCleared:   entry we've cleared to in the Lo receive ring
  54  * rxBuffReady:   next entry we'll put a free buffer in
  55  * respCleared:   entry we've cleared to in the response ring
  56  *
  57  * txLoCleared:   entry the NIC has cleared to in the Lo transmit ring
  58  * txHiCleared:   entry the NIC has cleared to in the Hi transmit ring
  59  * rxLoReady:     entry the NIC has filled to in the Lo receive ring
  60  * rxBuffCleared: entry the NIC has cleared in the free buffer ring
  61  * cmdCleared:    entry the NIC has cleared in the command ring
  62  * respReady:     entry the NIC has filled to in the response ring
  63  * rxHiReady:     entry the NIC has filled to in the Hi receive ring
  64  */
  65 struct typhoon_indexes {
  66         /* The first four are written by the host, and read by the NIC */
  67         volatile u32 rxHiCleared;
  68         volatile u32 rxLoCleared;
  69         volatile u32 rxBuffReady;
  70         volatile u32 respCleared;
  71
  72         /* The remaining are written by the NIC, and read by the host */
  73         volatile u32 txLoCleared;
  74         volatile u32 txHiCleared;
  75         volatile u32 rxLoReady;
  76         volatile u32 rxBuffCleared;
  77         volatile u32 cmdCleared;
  78         volatile u32 respReady;
  79         volatile u32 rxHiReady;
  80 } __attribute__ ((packed));
  81
  82 /* The host<->Typhoon interface
  83  * Our means of communicating where things are
  84  *
  85  * All values must be in little endian format for the 3XP
  86  *
  87  * ringIndex:   64 bit bus address of the index structure
  88  * txLoAddr:    64 bit bus address of the Lo transmit ring
  89  * txLoSize:    size (in bytes) of the Lo transmit ring
  90  * txHi*:       as above for the Hi priority transmit ring
  91  * rxLo*:       as above for the Lo priority receive ring
  92  * rxBuff*:     as above for the free buffer ring
  93  * cmd*:        as above for the command ring
  94  * resp*:       as above for the response ring
  95  * zeroAddr:    64 bit bus address of a zero word (for DMA)
  96  * rxHi*:       as above for the Hi Priority receive ring
  97  *
  98  * While there is room for 64 bit addresses, current versions of the 3XP
  99  * only do 32 bit addresses, so the *Hi for each of the above will always
 100  * be zero.
 101  */
 102 struct typhoon_interface {
 103         u32 ringIndex;
 104         u32 ringIndexHi;
 105         u32 txLoAddr;
 106         u32 txLoAddrHi;
 107         u32 txLoSize;
 108         u32 txHiAddr;
 109         u32 txHiAddrHi;
 110         u32 txHiSize;
 111         u32 rxLoAddr;
 112         u32 rxLoAddrHi;
 113         u32 rxLoSize;
 114         u32 rxBuffAddr;
 115         u32 rxBuffAddrHi;
 116         u32 rxBuffSize;
 117         u32 cmdAddr;
 118         u32 cmdAddrHi;
 119         u32 cmdSize;
 120         u32 respAddr;
 121         u32 respAddrHi;
 122         u32 respSize;
 123         u32 zeroAddr;
 124         u32 zeroAddrHi;
 125         u32 rxHiAddr;
 126         u32 rxHiAddrHi;
 127         u32 rxHiSize;
 128 } __attribute__ ((packed));
 129
 130 /* The Typhoon transmit/fragment descriptor
 131  *
 132  * A packet is described by a packet descriptor, followed by option descriptors,
 133  * if any, then one or more fragment descriptors.
 134  *
 135  * Packet descriptor:
 136  * flags:       Descriptor type
 137  * len:i        zero, or length of this packet
 138  * addr*:       8 bytes of opaque data to the firmware -- for skb pointer
 139  * processFlags: Determine offload tasks to perform on this packet.
 140  *
 141  * Fragment descriptor:
 142  * flags:       Descriptor type
 143  * len:i        length of this fragment
 144  * addr:        low bytes of DMA address for this part of the packet
 145  * addrHi:      hi bytes of DMA address for this part of the packet
 146  * processFlags: must be zero
 147  *
 148  * TYPHOON_DESC_VALID is not mentioned in their docs, but their Linux
 149  * driver uses it.
 150  */
 151 struct tx_desc {
 152         u8  flags;
 153 #define TYPHOON_TYPE_MASK       0x07
 154 #define         TYPHOON_FRAG_DESC       0x00
 155 #define         TYPHOON_TX_DESC         0x01
 156 #define         TYPHOON_CMD_DESC        0x02
 157 #define         TYPHOON_OPT_DESC        0x03
 158 #define         TYPHOON_RX_DESC         0x04
 159 #define         TYPHOON_RESP_DESC       0x05
 160 #define TYPHOON_OPT_TYPE_MASK   0xf0
 161 #define         TYPHOON_OPT_IPSEC       0x00
 162 #define         TYPHOON_OPT_TCP_SEG     0x10
 163 #define TYPHOON_CMD_RESPOND     0x40
 164 #define TYPHOON_RESP_ERROR      0x40
 165 #define TYPHOON_RX_ERROR        0x40
 166 #define TYPHOON_DESC_VALID      0x80
 167         u8  numDesc;
 168         u16 len;
 169         u32 addr;
 170         u32 addrHi;
 171         u32 processFlags;
 172 #define TYPHOON_TX_PF_NO_CRC            __constant_cpu_to_le32(0x00000001)
 173 #define TYPHOON_TX_PF_IP_CHKSUM         __constant_cpu_to_le32(0x00000002)
 174 #define TYPHOON_TX_PF_TCP_CHKSUM        __constant_cpu_to_le32(0x00000004)
 175 #define TYPHOON_TX_PF_TCP_SEGMENT       __constant_cpu_to_le32(0x00000008)
 176 #define TYPHOON_TX_PF_INSERT_VLAN       __constant_cpu_to_le32(0x00000010)
 177 #define TYPHOON_TX_PF_IPSEC             __constant_cpu_to_le32(0x00000020)
 178 #define TYPHOON_TX_PF_VLAN_PRIORITY     __constant_cpu_to_le32(0x00000040)
 179 #define TYPHOON_TX_PF_UDP_CHKSUM        __constant_cpu_to_le32(0x00000080)
 180 #define TYPHOON_TX_PF_PAD_FRAME         __constant_cpu_to_le32(0x00000100)
 181 #define TYPHOON_TX_PF_RESERVED          __constant_cpu_to_le32(0x00000e00)
 182 #define TYPHOON_TX_PF_VLAN_MASK         __constant_cpu_to_le32(0x0ffff000)
 183 #define TYPHOON_TX_PF_INTERNAL          __constant_cpu_to_le32(0xf0000000)
 184 #define TYPHOON_TX_PF_VLAN_TAG_SHIFT    12
 185 } __attribute__ ((packed));
 186
 187 /* The TCP Segmentation offload option descriptor
 188  *
 189  * flags:       descriptor type
 190  * numDesc:     must be 1
 191  * mss_flags:   bits 0-11 (little endian) are MSS, 12 is first TSO descriptor
 192  *                      13 is list TSO descriptor, set both if only one TSO
 193  * respAddrLo:  low bytes of address of the bytesTx field of this descriptor
 194  * bytesTx:     total number of bytes in this TSO request
 195  * status:      0 on completion
 196  */
 197 struct tcpopt_desc {
 198         u8  flags;
 199         u8  numDesc;
 200         u16 mss_flags;
 201 #define TYPHOON_TSO_FIRST               __constant_cpu_to_le16(0x1000)
 202 #define TYPHOON_TSO_LAST                __constant_cpu_to_le16(0x2000)
 203         u32 respAddrLo;
 204         u32 bytesTx;
 205         u32 status;
 206 } __attribute__ ((packed));
 207
 208 /* The IPSEC Offload descriptor
 209  *
 210  * flags:       descriptor type
 211  * numDesc:     must be 1
 212  * ipsecFlags:  bit 0: 0 -- generate IV, 1 -- use supplied IV
 213  * sa1, sa2:    Security Association IDs for this packet
 214  * reserved:    set to 0
 215  */
 216 struct ipsec_desc {
 217         u8  flags;
 218         u8  numDesc;
 219         u16 ipsecFlags;
 220 #define TYPHOON_IPSEC_GEN_IV    __constant_cpu_to_le16(0x0000)
 221 #define TYPHOON_IPSEC_USE_IV    __constant_cpu_to_le16(0x0001)
 222         u32 sa1;
 223         u32 sa2;
 224         u32 reserved;
 225 } __attribute__ ((packed));
 226
 227 /* The Typhoon receive descriptor (Updated by NIC)
 228  *
 229  * flags:         Descriptor type, error indication
 230  * numDesc:       Always zero
 231  * frameLen:      the size of the packet received
 232  * addr:          low 32 bytes of the virtual addr passed in for this buffer
 233  * addrHi:        high 32 bytes of the virtual addr passed in for this buffer
 234  * rxStatus:      Error if set in flags, otherwise result of offload processing
 235  * filterResults: results of filtering on packet, not used
 236  * ipsecResults:  Results of IPSEC processing
 237  * vlanTag:       the 801.2q TCI from the packet
 238  */
 239 struct rx_desc {
 240         u8  flags;
 241         u8  numDesc;
 242         u16 frameLen;
 243         u32 addr;
 244         u32 addrHi;
 245         u32 rxStatus;
 246 #define TYPHOON_RX_ERR_INTERNAL         __constant_cpu_to_le32(0x00000000)
 247 #define TYPHOON_RX_ERR_FIFO_UNDERRUN    __constant_cpu_to_le32(0x00000001)
 248 #define TYPHOON_RX_ERR_BAD_SSD          __constant_cpu_to_le32(0x00000002)
 249 #define TYPHOON_RX_ERR_RUNT             __constant_cpu_to_le32(0x00000003)
 250 #define TYPHOON_RX_ERR_CRC              __constant_cpu_to_le32(0x00000004)
 251 #define TYPHOON_RX_ERR_OVERSIZE         __constant_cpu_to_le32(0x00000005)
 252 #define TYPHOON_RX_ERR_ALIGN            __constant_cpu_to_le32(0x00000006)
 253 #define TYPHOON_RX_ERR_DRIBBLE          __constant_cpu_to_le32(0x00000007)
 254 #define TYPHOON_RX_PROTO_MASK           __constant_cpu_to_le32(0x00000003)
 255 #define TYPHOON_RX_PROTO_UNKNOWN        __constant_cpu_to_le32(0x00000000)
 256 #define TYPHOON_RX_PROTO_IP             __constant_cpu_to_le32(0x00000001)
 257 #define TYPHOON_RX_PROTO_IPX            __constant_cpu_to_le32(0x00000002)
 258 #define TYPHOON_RX_VLAN                 __constant_cpu_to_le32(0x00000004)
 259 #define TYPHOON_RX_IP_FRAG              __constant_cpu_to_le32(0x00000008)
 260 #define TYPHOON_RX_IPSEC                __constant_cpu_to_le32(0x00000010)
 261 #define TYPHOON_RX_IP_CHK_FAIL          __constant_cpu_to_le32(0x00000020)
 262 #define TYPHOON_RX_TCP_CHK_FAIL         __constant_cpu_to_le32(0x00000040)
 263 #define TYPHOON_RX_UDP_CHK_FAIL         __constant_cpu_to_le32(0x00000080)
 264 #define TYPHOON_RX_IP_CHK_GOOD          __constant_cpu_to_le32(0x00000100)
 265 #define TYPHOON_RX_TCP_CHK_GOOD         __constant_cpu_to_le32(0x00000200)
 266 #define TYPHOON_RX_UDP_CHK_GOOD         __constant_cpu_to_le32(0x00000400)
 267         u16 filterResults;
 268 #define TYPHOON_RX_FILTER_MASK          __constant_cpu_to_le16(0x7fff)
 269 #define TYPHOON_RX_FILTERED             __constant_cpu_to_le16(0x8000)
 270         u16 ipsecResults;
 271 #define TYPHOON_RX_OUTER_AH_GOOD        __constant_cpu_to_le16(0x0001)
 272 #define TYPHOON_RX_OUTER_ESP_GOOD       __constant_cpu_to_le16(0x0002)
 273 #define TYPHOON_RX_INNER_AH_GOOD        __constant_cpu_to_le16(0x0004)
 274 #define TYPHOON_RX_INNER_ESP_GOOD       __constant_cpu_to_le16(0x0008)
 275 #define TYPHOON_RX_OUTER_AH_FAIL        __constant_cpu_to_le16(0x0010)
 276 #define TYPHOON_RX_OUTER_ESP_FAIL       __constant_cpu_to_le16(0x0020)
 277 #define TYPHOON_RX_INNER_AH_FAIL        __constant_cpu_to_le16(0x0040)
 278 #define TYPHOON_RX_INNER_ESP_FAIL       __constant_cpu_to_le16(0x0080)
 279 #define TYPHOON_RX_UNKNOWN_SA           __constant_cpu_to_le16(0x0100)
 280 #define TYPHOON_RX_ESP_FORMAT_ERR       __constant_cpu_to_le16(0x0200)
 281         u32 vlanTag;
 282 } __attribute__ ((packed));
 283
 284 /* The Typhoon free buffer descriptor, used to give a buffer to the NIC
 285  *
 286  * physAddr:    low 32 bits of the bus address of the buffer
 287  * physAddrHi:  high 32 bits of the bus address of the buffer, always zero
 288  * virtAddr:    low 32 bits of the skb address
 289  * virtAddrHi:  high 32 bits of the skb address, always zero
 290  *
 291  * the virt* address is basically two 32 bit cookies, just passed back
 292  * from the NIC
 293  */
 294 struct rx_free {
 295         u32 physAddr;
 296         u32 physAddrHi;
 297         u32 virtAddr;
 298         u32 virtAddrHi;
 299 } __attribute__ ((packed));
 300
 301 /* The Typhoon command descriptor, used for commands and responses
 302  *
 303  * flags:   descriptor type
 304  * numDesc: number of descriptors following in this command/response,
 305  *                              ie, zero for a one descriptor command
 306  * cmd:     the command
 307  * seqNo:   sequence number (unused)
 308  * parm1:   use varies by command
 309  * parm2:   use varies by command
 310  * parm3:   use varies by command
 311  */
 312 struct cmd_desc {
 313         u8  flags;
 314         u8  numDesc;
 315         u16 cmd;
 316 #define TYPHOON_CMD_TX_ENABLE           __constant_cpu_to_le16(0x0001)
 317 #define TYPHOON_CMD_TX_DISABLE          __constant_cpu_to_le16(0x0002)
 318 #define TYPHOON_CMD_RX_ENABLE           __constant_cpu_to_le16(0x0003)
 319 #define TYPHOON_CMD_RX_DISABLE          __constant_cpu_to_le16(0x0004)
 320 #define TYPHOON_CMD_SET_RX_FILTER       __constant_cpu_to_le16(0x0005)
 321 #define TYPHOON_CMD_READ_STATS          __constant_cpu_to_le16(0x0007)
 322 #define TYPHOON_CMD_XCVR_SELECT         __constant_cpu_to_le16(0x0013)
 323 #define TYPHOON_CMD_SET_MAX_PKT_SIZE    __constant_cpu_to_le16(0x001a)
 324 #define TYPHOON_CMD_READ_MEDIA_STATUS   __constant_cpu_to_le16(0x001b)
 325 #define TYPHOON_CMD_GOTO_SLEEP          __constant_cpu_to_le16(0x0023)
 326 #define TYPHOON_CMD_SET_MULTICAST_HASH  __constant_cpu_to_le16(0x0025)
 327 #define TYPHOON_CMD_SET_MAC_ADDRESS     __constant_cpu_to_le16(0x0026)
 328 #define TYPHOON_CMD_READ_MAC_ADDRESS    __constant_cpu_to_le16(0x0027)
 329 #define TYPHOON_CMD_VLAN_TYPE_WRITE     __constant_cpu_to_le16(0x002b)
 330 #define TYPHOON_CMD_CREATE_SA           __constant_cpu_to_le16(0x0034)
 331 #define TYPHOON_CMD_DELETE_SA           __constant_cpu_to_le16(0x0035)
 332 #define TYPHOON_CMD_READ_VERSIONS       __constant_cpu_to_le16(0x0043)
 333 #define TYPHOON_CMD_IRQ_COALESCE_CTRL   __constant_cpu_to_le16(0x0045)
 334 #define TYPHOON_CMD_ENABLE_WAKE_EVENTS  __constant_cpu_to_le16(0x0049)
 335 #define TYPHOON_CMD_SET_OFFLOAD_TASKS   __constant_cpu_to_le16(0x004f)
 336 #define TYPHOON_CMD_HELLO_RESP          __constant_cpu_to_le16(0x0057)
 337 #define TYPHOON_CMD_HALT                __constant_cpu_to_le16(0x005d)
 338 #define TYPHOON_CMD_READ_IPSEC_INFO     __constant_cpu_to_le16(0x005e)
 339 #define TYPHOON_CMD_GET_IPSEC_ENABLE    __constant_cpu_to_le16(0x0067)
 340 #define TYPHOON_CMD_GET_CMD_LVL         __constant_cpu_to_le16(0x0069)
 341         u16 seqNo;
 342         u16 parm1;
 343         u32 parm2;
 344         u32 parm3;
 345 } __attribute__ ((packed));
 346
 347 /* The Typhoon response descriptor, see command descriptor for details
 348  */
 349 struct resp_desc {
 350         u8  flags;
 351         u8  numDesc;
 352         u16 cmd;
 353         u16 seqNo;
 354         u16 parm1;
 355         u32 parm2;
 356         u32 parm3;
 357 } __attribute__ ((packed));
 358
 359 #define INIT_COMMAND_NO_RESPONSE(x, command)                            \
 360         do { struct cmd_desc *_ptr = (x);                               \
 361                 memset(_ptr, 0, sizeof(struct cmd_desc));               \
 362                 _ptr->flags = TYPHOON_CMD_DESC | TYPHOON_DESC_VALID;    \
 363                 _ptr->cmd = command;                                    \
 364         } while(0)
 365
 366 /* We set seqNo to 1 if we're expecting a response from this command */
 367 #define INIT_COMMAND_WITH_RESPONSE(x, command)                          \
 368         do { struct cmd_desc *_ptr = (x);                               \
 369                 memset(_ptr, 0, sizeof(struct cmd_desc));               \
 370                 _ptr->flags = TYPHOON_CMD_RESPOND | TYPHOON_CMD_DESC;   \
 371                 _ptr->flags |= TYPHOON_DESC_VALID;                      \
 372                 _ptr->cmd = command;                                    \
 373                 _ptr->seqNo = 1;                                        \
 374         } while(0)
 375
 376 /* TYPHOON_CMD_SET_RX_FILTER filter bits (cmd.parm1)
 377  */
 378 #define TYPHOON_RX_FILTER_DIRECTED      __constant_cpu_to_le16(0x0001)
 379 #define TYPHOON_RX_FILTER_ALL_MCAST     __constant_cpu_to_le16(0x0002)
 380 #define TYPHOON_RX_FILTER_BROADCAST     __constant_cpu_to_le16(0x0004)
 381 #define TYPHOON_RX_FILTER_PROMISCOUS    __constant_cpu_to_le16(0x0008)
 382 #define TYPHOON_RX_FILTER_MCAST_HASH    __constant_cpu_to_le16(0x0010)
 383
 384 /* TYPHOON_CMD_READ_STATS response format
 385  */
 386 struct stats_resp {
 387         u8  flags;
 388         u8  numDesc;
 389         u16 cmd;
 390         u16 seqNo;
 391         u16 unused;
 392         u32 txPackets;
 393         u64 txBytes;
 394         u32 txDeferred;
 395         u32 txLateCollisions;
 396         u32 txCollisions;
 397         u32 txCarrierLost;
 398         u32 txMultipleCollisions;
 399         u32 txExcessiveCollisions;
 400         u32 txFifoUnderruns;
 401         u32 txMulticastTxOverflows;
 402         u32 txFiltered;
 403         u32 rxPacketsGood;
 404         u64 rxBytesGood;
 405         u32 rxFifoOverruns;
 406         u32 BadSSD;
 407         u32 rxCrcErrors;
 408         u32 rxOversized;
 409         u32 rxBroadcast;
 410         u32 rxMulticast;
 411         u32 rxOverflow;
 412         u32 rxFiltered;
 413         u32 linkStatus;
 414 #define TYPHOON_LINK_STAT_MASK          __constant_cpu_to_le32(0x00000001)
 415 #define TYPHOON_LINK_GOOD               __constant_cpu_to_le32(0x00000001)
 416 #define TYPHOON_LINK_BAD                __constant_cpu_to_le32(0x00000000)
 417 #define TYPHOON_LINK_SPEED_MASK         __constant_cpu_to_le32(0x00000002)
 418 #define TYPHOON_LINK_100MBPS            __constant_cpu_to_le32(0x00000002)
 419 #define TYPHOON_LINK_10MBPS             __constant_cpu_to_le32(0x00000000)
 420 #define TYPHOON_LINK_DUPLEX_MASK        __constant_cpu_to_le32(0x00000004)
 421 #define TYPHOON_LINK_FULL_DUPLEX        __constant_cpu_to_le32(0x00000004)
 422 #define TYPHOON_LINK_HALF_DUPLEX        __constant_cpu_to_le32(0x00000000)
 423         u32 unused2;
 424         u32 unused3;
 425 } __attribute__ ((packed));
 426
 427 /* TYPHOON_CMD_XCVR_SELECT xcvr values (resp.parm1)
 428  */
 429 #define TYPHOON_XCVR_10HALF     __constant_cpu_to_le16(0x0000)
 430 #define TYPHOON_XCVR_10FULL     __constant_cpu_to_le16(0x0001)
 431 #define TYPHOON_XCVR_100HALF    __constant_cpu_to_le16(0x0002)
 432 #define TYPHOON_XCVR_100FULL    __constant_cpu_to_le16(0x0003)
 433 #define TYPHOON_XCVR_AUTONEG    __constant_cpu_to_le16(0x0004)
 434
 435 /* TYPHOON_CMD_READ_MEDIA_STATUS (resp.parm1)
 436  */
 437 #define TYPHOON_MEDIA_STAT_CRC_STRIP_DISABLE    __constant_cpu_to_le16(0x0004)
 438 #define TYPHOON_MEDIA_STAT_COLLISION_DETECT     __constant_cpu_to_le16(0x0010)
 439 #define TYPHOON_MEDIA_STAT_CARRIER_SENSE        __constant_cpu_to_le16(0x0020)
 440 #define TYPHOON_MEDIA_STAT_POLARITY_REV         __constant_cpu_to_le16(0x0400)
 441 #define TYPHOON_MEDIA_STAT_NO_LINK              __constant_cpu_to_le16(0x0800)
 442
 443 /* TYPHOON_CMD_SET_MULTICAST_HASH enable values (cmd.parm1)
 444  */
 445 #define TYPHOON_MCAST_HASH_DISABLE      __constant_cpu_to_le16(0x0000)
 446 #define TYPHOON_MCAST_HASH_ENABLE       __constant_cpu_to_le16(0x0001)
 447 #define TYPHOON_MCAST_HASH_SET          __constant_cpu_to_le16(0x0002)
 448
 449 /* TYPHOON_CMD_CREATE_SA descriptor and settings
 450  */
 451 struct sa_descriptor {
 452         u8  flags;
 453         u8  numDesc;
 454         u16 cmd;
 455         u16 seqNo;
 456         u16 mode;
 457 #define TYPHOON_SA_MODE_NULL            __constant_cpu_to_le16(0x0000)
 458 #define TYPHOON_SA_MODE_AH              __constant_cpu_to_le16(0x0001)
 459 #define TYPHOON_SA_MODE_ESP             __constant_cpu_to_le16(0x0002)
 460         u8  hashFlags;
 461 #define TYPHOON_SA_HASH_ENABLE          0x01
 462 #define TYPHOON_SA_HASH_SHA1            0x02
 463 #define TYPHOON_SA_HASH_MD5             0x04
 464         u8  direction;
 465 #define TYPHOON_SA_DIR_RX               0x00
 466 #define TYPHOON_SA_DIR_TX               0x01
 467         u8  encryptionFlags;
 468 #define TYPHOON_SA_ENCRYPT_ENABLE       0x01
 469 #define TYPHOON_SA_ENCRYPT_DES          0x02
 470 #define TYPHOON_SA_ENCRYPT_3DES         0x00
 471 #define TYPHOON_SA_ENCRYPT_3DES_2KEY    0x00
 472 #define TYPHOON_SA_ENCRYPT_3DES_3KEY    0x04
 473 #define TYPHOON_SA_ENCRYPT_CBC          0x08
 474 #define TYPHOON_SA_ENCRYPT_ECB          0x00
 475         u8  specifyIndex;
 476 #define TYPHOON_SA_SPECIFY_INDEX        0x01
 477 #define TYPHOON_SA_GENERATE_INDEX       0x00
 478         u32 SPI;
 479         u32 destAddr;
 480         u32 destMask;
 481         u8  integKey[20];
 482         u8  confKey[24];
 483         u32 index;
 484         u32 unused;
 485         u32 unused2;
 486 } __attribute__ ((packed));
 487
 488 /* TYPHOON_CMD_SET_OFFLOAD_TASKS bits (cmd.parm2 (Tx) & cmd.parm3 (Rx))
 489  * This is all for IPv4.
 490  */
 491 #define TYPHOON_OFFLOAD_TCP_CHKSUM      __constant_cpu_to_le32(0x00000002)
 492 #define TYPHOON_OFFLOAD_UDP_CHKSUM      __constant_cpu_to_le32(0x00000004)
 493 #define TYPHOON_OFFLOAD_IP_CHKSUM       __constant_cpu_to_le32(0x00000008)
 494 #define TYPHOON_OFFLOAD_IPSEC           __constant_cpu_to_le32(0x00000010)
 495 #define TYPHOON_OFFLOAD_BCAST_THROTTLE  __constant_cpu_to_le32(0x00000020)
 496 #define TYPHOON_OFFLOAD_DHCP_PREVENT    __constant_cpu_to_le32(0x00000040)
 497 #define TYPHOON_OFFLOAD_VLAN            __constant_cpu_to_le32(0x00000080)
 498 #define TYPHOON_OFFLOAD_FILTERING       __constant_cpu_to_le32(0x00000100)
 499 #define TYPHOON_OFFLOAD_TCP_SEGMENT     __constant_cpu_to_le32(0x00000200)
 500
 501 /* TYPHOON_CMD_ENABLE_WAKE_EVENTS bits (cmd.parm1)
 502  */
 503 #define TYPHOON_WAKE_MAGIC_PKT          __constant_cpu_to_le16(0x01)
 504 #define TYPHOON_WAKE_LINK_EVENT         __constant_cpu_to_le16(0x02)
 505 #define TYPHOON_WAKE_ICMP_ECHO          __constant_cpu_to_le16(0x04)
 506 #define TYPHOON_WAKE_ARP                __constant_cpu_to_le16(0x08)
 507
 508 /* These are used to load the firmware image on the NIC
 509  */
 510 struct typhoon_file_header {
 511         u8  tag[8];
 512         u32 version;
 513         u32 numSections;
 514         u32 startAddr;
 515         u32 hmacDigest[5];
 516 } __attribute__ ((packed));
 517
 518 struct typhoon_section_header {
 519         u32 len;
 520         u16 checksum;
 521         u16 reserved;
 522         u32 startAddr;
 523 } __attribute__ ((packed));
 524
 525 /* The Typhoon Register offsets
 526  */
 527 #define TYPHOON_REG_SOFT_RESET                  0x00
 528 #define TYPHOON_REG_INTR_STATUS                 0x04
 529 #define TYPHOON_REG_INTR_ENABLE                 0x08
 530 #define TYPHOON_REG_INTR_MASK                   0x0c
 531 #define TYPHOON_REG_SELF_INTERRUPT              0x10
 532 #define TYPHOON_REG_HOST2ARM7                   0x14
 533 #define TYPHOON_REG_HOST2ARM6                   0x18
 534 #define TYPHOON_REG_HOST2ARM5                   0x1c
 535 #define TYPHOON_REG_HOST2ARM4                   0x20
 536 #define TYPHOON_REG_HOST2ARM3                   0x24
 537 #define TYPHOON_REG_HOST2ARM2                   0x28
 538 #define TYPHOON_REG_HOST2ARM1                   0x2c
 539 #define TYPHOON_REG_HOST2ARM0                   0x30
 540 #define TYPHOON_REG_ARM2HOST3                   0x34
 541 #define TYPHOON_REG_ARM2HOST2                   0x38
 542 #define TYPHOON_REG_ARM2HOST1                   0x3c
 543 #define TYPHOON_REG_ARM2HOST0                   0x40
 544
 545 #define TYPHOON_REG_BOOT_DATA_LO                TYPHOON_REG_HOST2ARM5
 546 #define TYPHOON_REG_BOOT_DATA_HI                TYPHOON_REG_HOST2ARM4
 547 #define TYPHOON_REG_BOOT_DEST_ADDR              TYPHOON_REG_HOST2ARM3
 548 #define TYPHOON_REG_BOOT_CHECKSUM               TYPHOON_REG_HOST2ARM2
 549 #define TYPHOON_REG_BOOT_LENGTH                 TYPHOON_REG_HOST2ARM1
 550
 551 #define TYPHOON_REG_DOWNLOAD_BOOT_ADDR          TYPHOON_REG_HOST2ARM1
 552 #define TYPHOON_REG_DOWNLOAD_HMAC_0             TYPHOON_REG_HOST2ARM2
 553 #define TYPHOON_REG_DOWNLOAD_HMAC_1             TYPHOON_REG_HOST2ARM3
 554 #define TYPHOON_REG_DOWNLOAD_HMAC_2             TYPHOON_REG_HOST2ARM4
 555 #define TYPHOON_REG_DOWNLOAD_HMAC_3             TYPHOON_REG_HOST2ARM5
 556 #define TYPHOON_REG_DOWNLOAD_HMAC_4             TYPHOON_REG_HOST2ARM6
 557
 558 #define TYPHOON_REG_BOOT_RECORD_ADDR_HI         TYPHOON_REG_HOST2ARM2
 559 #define TYPHOON_REG_BOOT_RECORD_ADDR_LO         TYPHOON_REG_HOST2ARM1
 560
 561 #define TYPHOON_REG_TX_LO_READY                 TYPHOON_REG_HOST2ARM3
 562 #define TYPHOON_REG_CMD_READY                   TYPHOON_REG_HOST2ARM2
 563 #define TYPHOON_REG_TX_HI_READY                 TYPHOON_REG_HOST2ARM1
 564
 565 #define TYPHOON_REG_COMMAND                     TYPHOON_REG_HOST2ARM0
 566 #define TYPHOON_REG_HEARTBEAT                   TYPHOON_REG_ARM2HOST3
 567 #define TYPHOON_REG_STATUS                      TYPHOON_REG_ARM2HOST0
 568
 569 /* 3XP Reset values (TYPHOON_REG_SOFT_RESET)
 570  */
 571 #define TYPHOON_RESET_ALL       0x7f
 572 #define TYPHOON_RESET_NONE      0x00
 573
 574 /* 3XP irq bits (TYPHOON_REG_INTR{STATUS,ENABLE,MASK})
 575  *
 576  * Some of these came from OpenBSD, as the 3Com docs have it wrong
 577  * (INTR_SELF) or don't list it at all (INTR_*_ABORT)
 578  *
 579  * Enabling irqs on the Heartbeat reg (ArmToHost3) gets you an irq
 580  * about every 8ms, so don't do it.
 581  */
 582 #define TYPHOON_INTR_HOST_INT           0x00000001
 583 #define TYPHOON_INTR_ARM2HOST0          0x00000002
 584 #define TYPHOON_INTR_ARM2HOST1          0x00000004
 585 #define TYPHOON_INTR_ARM2HOST2          0x00000008
 586 #define TYPHOON_INTR_ARM2HOST3          0x00000010
 587 #define TYPHOON_INTR_DMA0               0x00000020
 588 #define TYPHOON_INTR_DMA1               0x00000040
 589 #define TYPHOON_INTR_DMA2               0x00000080
 590 #define TYPHOON_INTR_DMA3               0x00000100
 591 #define TYPHOON_INTR_MASTER_ABORT       0x00000200
 592 #define TYPHOON_INTR_TARGET_ABORT       0x00000400
 593 #define TYPHOON_INTR_SELF               0x00000800
 594 #define TYPHOON_INTR_RESERVED           0xfffff000
 595
 596 #define TYPHOON_INTR_BOOTCMD            TYPHOON_INTR_ARM2HOST0
 597
 598 #define TYPHOON_INTR_ENABLE_ALL         0xffffffef
 599 #define TYPHOON_INTR_ALL                0xffffffff
 600 #define TYPHOON_INTR_NONE               0x00000000
 601
 602 /* The commands for the 3XP chip (TYPHOON_REG_COMMAND)
 603  */
 604 #define TYPHOON_BOOTCMD_BOOT                    0x00
 605 #define TYPHOON_BOOTCMD_WAKEUP                  0xfa
 606 #define TYPHOON_BOOTCMD_DNLD_COMPLETE           0xfb
 607 #define TYPHOON_BOOTCMD_SEG_AVAILABLE           0xfc
 608 #define TYPHOON_BOOTCMD_RUNTIME_IMAGE           0xfd
 609 #define TYPHOON_BOOTCMD_REG_BOOT_RECORD         0xff
 610
 611 /* 3XP Status values (TYPHOON_REG_STATUS)
 612  */
 613 #define TYPHOON_STATUS_WAITING_FOR_BOOT         0x07
 614 #define TYPHOON_STATUS_SECOND_INIT              0x08
 615 #define TYPHOON_STATUS_RUNNING                  0x09
 616 #define TYPHOON_STATUS_WAITING_FOR_HOST         0x0d
 617 #define TYPHOON_STATUS_WAITING_FOR_SEGMENT      0x10
 618 #define TYPHOON_STATUS_SLEEPING                 0x11
 619 #define TYPHOON_STATUS_HALTED                   0x14