linux-stable/drivers/net/ethernet/sun/sunhme.h
Greg Kroah-Hartman b24413180f License cleanup: add SPDX GPL-2.0 license identifier to files with no license
Many source files in the tree are missing licensing information, which
makes it harder for compliance tools to determine the correct license.

By default all files without license information are under the default
license of the kernel, which is GPL version 2.

Update the files which contain no license information with the 'GPL-2.0'
SPDX license identifier.  The SPDX identifier is a legally binding
shorthand, which can be used instead of the full boiler plate text.

This patch is based on work done by Thomas Gleixner and Kate Stewart and
Philippe Ombredanne.

How this work was done:

Patches were generated and checked against linux-4.14-rc6 for a subset of
the use cases:
 - file had no licensing information it it.
 - file was a */uapi/* one with no licensing information in it,
 - file was a */uapi/* one with existing licensing information,

Further patches will be generated in subsequent months to fix up cases
where non-standard license headers were used, and references to license
had to be inferred by heuristics based on keywords.

The analysis to determine which SPDX License Identifier to be applied to
a file was done in a spreadsheet of side by side results from of the
output of two independent scanners (ScanCode & Windriver) producing SPDX
tag:value files created by Philippe Ombredanne.  Philippe prepared the
base worksheet, and did an initial spot review of a few 1000 files.

The 4.13 kernel was the starting point of the analysis with 60,537 files
assessed.  Kate Stewart did a file by file comparison of the scanner
results in the spreadsheet to determine which SPDX license identifier(s)
to be applied to the file. She confirmed any determination that was not
immediately clear with lawyers working with the Linux Foundation.

Criteria used to select files for SPDX license identifier tagging was:
 - Files considered eligible had to be source code files.
 - Make and config files were included as candidates if they contained >5
   lines of source
 - File already had some variant of a license header in it (even if <5
   lines).

All documentation files were explicitly excluded.

The following heuristics were used to determine which SPDX license
identifiers to apply.

 - when both scanners couldn't find any license traces, file was
   considered to have no license information in it, and the top level
   COPYING file license applied.

   For non */uapi/* files that summary was:

   SPDX license identifier                            # files
   ---------------------------------------------------|-------
   GPL-2.0                                              11139

   and resulted in the first patch in this series.

   If that file was a */uapi/* path one, it was "GPL-2.0 WITH
   Linux-syscall-note" otherwise it was "GPL-2.0".  Results of that was:

   SPDX license identifier                            # files
   ---------------------------------------------------|-------
   GPL-2.0 WITH Linux-syscall-note                        930

   and resulted in the second patch in this series.

 - if a file had some form of licensing information in it, and was one
   of the */uapi/* ones, it was denoted with the Linux-syscall-note if
   any GPL family license was found in the file or had no licensing in
   it (per prior point).  Results summary:

   SPDX license identifier                            # files
   ---------------------------------------------------|------
   GPL-2.0 WITH Linux-syscall-note                       270
   GPL-2.0+ WITH Linux-syscall-note                      169
   ((GPL-2.0 WITH Linux-syscall-note) OR BSD-2-Clause)    21
   ((GPL-2.0 WITH Linux-syscall-note) OR BSD-3-Clause)    17
   LGPL-2.1+ WITH Linux-syscall-note                      15
   GPL-1.0+ WITH Linux-syscall-note                       14
   ((GPL-2.0+ WITH Linux-syscall-note) OR BSD-3-Clause)    5
   LGPL-2.0+ WITH Linux-syscall-note                       4
   LGPL-2.1 WITH Linux-syscall-note                        3
   ((GPL-2.0 WITH Linux-syscall-note) OR MIT)              3
   ((GPL-2.0 WITH Linux-syscall-note) AND MIT)             1

   and that resulted in the third patch in this series.

 - when the two scanners agreed on the detected license(s), that became
   the concluded license(s).

 - when there was disagreement between the two scanners (one detected a
   license but the other didn't, or they both detected different
   licenses) a manual inspection of the file occurred.

 - In most cases a manual inspection of the information in the file
   resulted in a clear resolution of the license that should apply (and
   which scanner probably needed to revisit its heuristics).

 - When it was not immediately clear, the license identifier was
   confirmed with lawyers working with the Linux Foundation.

 - If there was any question as to the appropriate license identifier,
   the file was flagged for further research and to be revisited later
   in time.

In total, over 70 hours of logged manual review was done on the
spreadsheet to determine the SPDX license identifiers to apply to the
source files by Kate, Philippe, Thomas and, in some cases, confirmation
by lawyers working with the Linux Foundation.

Kate also obtained a third independent scan of the 4.13 code base from
FOSSology, and compared selected files where the other two scanners
disagreed against that SPDX file, to see if there was new insights.  The
Windriver scanner is based on an older version of FOSSology in part, so
they are related.

Thomas did random spot checks in about 500 files from the spreadsheets
for the uapi headers and agreed with SPDX license identifier in the
files he inspected. For the non-uapi files Thomas did random spot checks
in about 15000 files.

In initial set of patches against 4.14-rc6, 3 files were found to have
copy/paste license identifier errors, and have been fixed to reflect the
correct identifier.

Additionally Philippe spent 10 hours this week doing a detailed manual
inspection and review of the 12,461 patched files from the initial patch
version early this week with:
 - a full scancode scan run, collecting the matched texts, detected
   license ids and scores
 - reviewing anything where there was a license detected (about 500+
   files) to ensure that the applied SPDX license was correct
 - reviewing anything where there was no detection but the patch license
   was not GPL-2.0 WITH Linux-syscall-note to ensure that the applied
   SPDX license was correct

This produced a worksheet with 20 files needing minor correction.  This
worksheet was then exported into 3 different .csv files for the
different types of files to be modified.

These .csv files were then reviewed by Greg.  Thomas wrote a script to
parse the csv files and add the proper SPDX tag to the file, in the
format that the file expected.  This script was further refined by Greg
based on the output to detect more types of files automatically and to
distinguish between header and source .c files (which need different
comment types.)  Finally Greg ran the script using the .csv files to
generate the patches.

Reviewed-by: Kate Stewart <kstewart@linuxfoundation.org>
Reviewed-by: Philippe Ombredanne <pombredanne@nexb.com>
Reviewed-by: Thomas Gleixner <tglx@linutronix.de>
Signed-off-by: Greg Kroah-Hartman <gregkh@linuxfoundation.org>
2017-11-02 11:10:55 +01:00

512 lines
27 KiB
C

/* SPDX-License-Identifier: GPL-2.0 */
/* $Id: sunhme.h,v 1.33 2001/08/03 06:23:04 davem Exp $
* sunhme.h: Definitions for Sparc HME/BigMac 10/100baseT ethernet driver.
* Also known as the "Happy Meal".
*
* Copyright (C) 1996, 1999 David S. Miller (davem@redhat.com)
*/
#ifndef _SUNHME_H
#define _SUNHME_H
#include <linux/pci.h>
/* Happy Meal global registers. */
#define GREG_SWRESET 0x000UL /* Software Reset */
#define GREG_CFG 0x004UL /* Config Register */
#define GREG_STAT 0x100UL /* Status */
#define GREG_IMASK 0x104UL /* Interrupt Mask */
#define GREG_REG_SIZE 0x108UL
/* Global reset register. */
#define GREG_RESET_ETX 0x01
#define GREG_RESET_ERX 0x02
#define GREG_RESET_ALL 0x03
/* Global config register. */
#define GREG_CFG_BURSTMSK 0x03
#define GREG_CFG_BURST16 0x00
#define GREG_CFG_BURST32 0x01
#define GREG_CFG_BURST64 0x02
#define GREG_CFG_64BIT 0x04
#define GREG_CFG_PARITY 0x08
#define GREG_CFG_RESV 0x10
/* Global status register. */
#define GREG_STAT_GOTFRAME 0x00000001 /* Received a frame */
#define GREG_STAT_RCNTEXP 0x00000002 /* Receive frame counter expired */
#define GREG_STAT_ACNTEXP 0x00000004 /* Align-error counter expired */
#define GREG_STAT_CCNTEXP 0x00000008 /* CRC-error counter expired */
#define GREG_STAT_LCNTEXP 0x00000010 /* Length-error counter expired */
#define GREG_STAT_RFIFOVF 0x00000020 /* Receive FIFO overflow */
#define GREG_STAT_CVCNTEXP 0x00000040 /* Code-violation counter expired */
#define GREG_STAT_STSTERR 0x00000080 /* Test error in XIF for SQE */
#define GREG_STAT_SENTFRAME 0x00000100 /* Transmitted a frame */
#define GREG_STAT_TFIFO_UND 0x00000200 /* Transmit FIFO underrun */
#define GREG_STAT_MAXPKTERR 0x00000400 /* Max-packet size error */
#define GREG_STAT_NCNTEXP 0x00000800 /* Normal-collision counter expired */
#define GREG_STAT_ECNTEXP 0x00001000 /* Excess-collision counter expired */
#define GREG_STAT_LCCNTEXP 0x00002000 /* Late-collision counter expired */
#define GREG_STAT_FCNTEXP 0x00004000 /* First-collision counter expired */
#define GREG_STAT_DTIMEXP 0x00008000 /* Defer-timer expired */
#define GREG_STAT_RXTOHOST 0x00010000 /* Moved from receive-FIFO to host memory */
#define GREG_STAT_NORXD 0x00020000 /* No more receive descriptors */
#define GREG_STAT_RXERR 0x00040000 /* Error during receive dma */
#define GREG_STAT_RXLATERR 0x00080000 /* Late error during receive dma */
#define GREG_STAT_RXPERR 0x00100000 /* Parity error during receive dma */
#define GREG_STAT_RXTERR 0x00200000 /* Tag error during receive dma */
#define GREG_STAT_EOPERR 0x00400000 /* Transmit descriptor did not have EOP set */
#define GREG_STAT_MIFIRQ 0x00800000 /* MIF is signaling an interrupt condition */
#define GREG_STAT_HOSTTOTX 0x01000000 /* Moved from host memory to transmit-FIFO */
#define GREG_STAT_TXALL 0x02000000 /* Transmitted all packets in the tx-fifo */
#define GREG_STAT_TXEACK 0x04000000 /* Error during transmit dma */
#define GREG_STAT_TXLERR 0x08000000 /* Late error during transmit dma */
#define GREG_STAT_TXPERR 0x10000000 /* Parity error during transmit dma */
#define GREG_STAT_TXTERR 0x20000000 /* Tag error during transmit dma */
#define GREG_STAT_SLVERR 0x40000000 /* PIO access got an error */
#define GREG_STAT_SLVPERR 0x80000000 /* PIO access got a parity error */
/* All interesting error conditions. */
#define GREG_STAT_ERRORS 0xfc7efefc
/* Global interrupt mask register. */
#define GREG_IMASK_GOTFRAME 0x00000001 /* Received a frame */
#define GREG_IMASK_RCNTEXP 0x00000002 /* Receive frame counter expired */
#define GREG_IMASK_ACNTEXP 0x00000004 /* Align-error counter expired */
#define GREG_IMASK_CCNTEXP 0x00000008 /* CRC-error counter expired */
#define GREG_IMASK_LCNTEXP 0x00000010 /* Length-error counter expired */
#define GREG_IMASK_RFIFOVF 0x00000020 /* Receive FIFO overflow */
#define GREG_IMASK_CVCNTEXP 0x00000040 /* Code-violation counter expired */
#define GREG_IMASK_STSTERR 0x00000080 /* Test error in XIF for SQE */
#define GREG_IMASK_SENTFRAME 0x00000100 /* Transmitted a frame */
#define GREG_IMASK_TFIFO_UND 0x00000200 /* Transmit FIFO underrun */
#define GREG_IMASK_MAXPKTERR 0x00000400 /* Max-packet size error */
#define GREG_IMASK_NCNTEXP 0x00000800 /* Normal-collision counter expired */
#define GREG_IMASK_ECNTEXP 0x00001000 /* Excess-collision counter expired */
#define GREG_IMASK_LCCNTEXP 0x00002000 /* Late-collision counter expired */
#define GREG_IMASK_FCNTEXP 0x00004000 /* First-collision counter expired */
#define GREG_IMASK_DTIMEXP 0x00008000 /* Defer-timer expired */
#define GREG_IMASK_RXTOHOST 0x00010000 /* Moved from receive-FIFO to host memory */
#define GREG_IMASK_NORXD 0x00020000 /* No more receive descriptors */
#define GREG_IMASK_RXERR 0x00040000 /* Error during receive dma */
#define GREG_IMASK_RXLATERR 0x00080000 /* Late error during receive dma */
#define GREG_IMASK_RXPERR 0x00100000 /* Parity error during receive dma */
#define GREG_IMASK_RXTERR 0x00200000 /* Tag error during receive dma */
#define GREG_IMASK_EOPERR 0x00400000 /* Transmit descriptor did not have EOP set */
#define GREG_IMASK_MIFIRQ 0x00800000 /* MIF is signaling an interrupt condition */
#define GREG_IMASK_HOSTTOTX 0x01000000 /* Moved from host memory to transmit-FIFO */
#define GREG_IMASK_TXALL 0x02000000 /* Transmitted all packets in the tx-fifo */
#define GREG_IMASK_TXEACK 0x04000000 /* Error during transmit dma */
#define GREG_IMASK_TXLERR 0x08000000 /* Late error during transmit dma */
#define GREG_IMASK_TXPERR 0x10000000 /* Parity error during transmit dma */
#define GREG_IMASK_TXTERR 0x20000000 /* Tag error during transmit dma */
#define GREG_IMASK_SLVERR 0x40000000 /* PIO access got an error */
#define GREG_IMASK_SLVPERR 0x80000000 /* PIO access got a parity error */
/* Happy Meal external transmitter registers. */
#define ETX_PENDING 0x00UL /* Transmit pending/wakeup register */
#define ETX_CFG 0x04UL /* Transmit config register */
#define ETX_RING 0x08UL /* Transmit ring pointer */
#define ETX_BBASE 0x0cUL /* Transmit buffer base */
#define ETX_BDISP 0x10UL /* Transmit buffer displacement */
#define ETX_FIFOWPTR 0x14UL /* FIFO write ptr */
#define ETX_FIFOSWPTR 0x18UL /* FIFO write ptr (shadow register) */
#define ETX_FIFORPTR 0x1cUL /* FIFO read ptr */
#define ETX_FIFOSRPTR 0x20UL /* FIFO read ptr (shadow register) */
#define ETX_FIFOPCNT 0x24UL /* FIFO packet counter */
#define ETX_SMACHINE 0x28UL /* Transmitter state machine */
#define ETX_RSIZE 0x2cUL /* Ring descriptor size */
#define ETX_BPTR 0x30UL /* Transmit data buffer ptr */
#define ETX_REG_SIZE 0x34UL
/* ETX transmit pending register. */
#define ETX_TP_DMAWAKEUP 0x00000001 /* Restart transmit dma */
/* ETX config register. */
#define ETX_CFG_DMAENABLE 0x00000001 /* Enable transmit dma */
#define ETX_CFG_FIFOTHRESH 0x000003fe /* Transmit FIFO threshold */
#define ETX_CFG_IRQDAFTER 0x00000400 /* Interrupt after TX-FIFO drained */
#define ETX_CFG_IRQDBEFORE 0x00000000 /* Interrupt before TX-FIFO drained */
#define ETX_RSIZE_SHIFT 4
/* Happy Meal external receiver registers. */
#define ERX_CFG 0x00UL /* Receiver config register */
#define ERX_RING 0x04UL /* Receiver ring ptr */
#define ERX_BPTR 0x08UL /* Receiver buffer ptr */
#define ERX_FIFOWPTR 0x0cUL /* FIFO write ptr */
#define ERX_FIFOSWPTR 0x10UL /* FIFO write ptr (shadow register) */
#define ERX_FIFORPTR 0x14UL /* FIFO read ptr */
#define ERX_FIFOSRPTR 0x18UL /* FIFO read ptr (shadow register) */
#define ERX_SMACHINE 0x1cUL /* Receiver state machine */
#define ERX_REG_SIZE 0x20UL
/* ERX config register. */
#define ERX_CFG_DMAENABLE 0x00000001 /* Enable receive DMA */
#define ERX_CFG_RESV1 0x00000006 /* Unused... */
#define ERX_CFG_BYTEOFFSET 0x00000038 /* Receive first byte offset */
#define ERX_CFG_RESV2 0x000001c0 /* Unused... */
#define ERX_CFG_SIZE32 0x00000000 /* Receive ring size == 32 */
#define ERX_CFG_SIZE64 0x00000200 /* Receive ring size == 64 */
#define ERX_CFG_SIZE128 0x00000400 /* Receive ring size == 128 */
#define ERX_CFG_SIZE256 0x00000600 /* Receive ring size == 256 */
#define ERX_CFG_RESV3 0x0000f800 /* Unused... */
#define ERX_CFG_CSUMSTART 0x007f0000 /* Offset of checksum start,
* in halfwords. */
/* I'd like a Big Mac, small fries, small coke, and SparcLinux please. */
#define BMAC_XIFCFG 0x0000UL /* XIF config register */
/* 0x4-->0x204, reserved */
#define BMAC_TXSWRESET 0x208UL /* Transmitter software reset */
#define BMAC_TXCFG 0x20cUL /* Transmitter config register */
#define BMAC_IGAP1 0x210UL /* Inter-packet gap 1 */
#define BMAC_IGAP2 0x214UL /* Inter-packet gap 2 */
#define BMAC_ALIMIT 0x218UL /* Transmit attempt limit */
#define BMAC_STIME 0x21cUL /* Transmit slot time */
#define BMAC_PLEN 0x220UL /* Size of transmit preamble */
#define BMAC_PPAT 0x224UL /* Pattern for transmit preamble */
#define BMAC_TXSDELIM 0x228UL /* Transmit delimiter */
#define BMAC_JSIZE 0x22cUL /* Jam size */
#define BMAC_TXMAX 0x230UL /* Transmit max pkt size */
#define BMAC_TXMIN 0x234UL /* Transmit min pkt size */
#define BMAC_PATTEMPT 0x238UL /* Count of transmit peak attempts */
#define BMAC_DTCTR 0x23cUL /* Transmit defer timer */
#define BMAC_NCCTR 0x240UL /* Transmit normal-collision counter */
#define BMAC_FCCTR 0x244UL /* Transmit first-collision counter */
#define BMAC_EXCTR 0x248UL /* Transmit excess-collision counter */
#define BMAC_LTCTR 0x24cUL /* Transmit late-collision counter */
#define BMAC_RSEED 0x250UL /* Transmit random number seed */
#define BMAC_TXSMACHINE 0x254UL /* Transmit state machine */
/* 0x258-->0x304, reserved */
#define BMAC_RXSWRESET 0x308UL /* Receiver software reset */
#define BMAC_RXCFG 0x30cUL /* Receiver config register */
#define BMAC_RXMAX 0x310UL /* Receive max pkt size */
#define BMAC_RXMIN 0x314UL /* Receive min pkt size */
#define BMAC_MACADDR2 0x318UL /* Ether address register 2 */
#define BMAC_MACADDR1 0x31cUL /* Ether address register 1 */
#define BMAC_MACADDR0 0x320UL /* Ether address register 0 */
#define BMAC_FRCTR 0x324UL /* Receive frame receive counter */
#define BMAC_GLECTR 0x328UL /* Receive giant-length error counter */
#define BMAC_UNALECTR 0x32cUL /* Receive unaligned error counter */
#define BMAC_RCRCECTR 0x330UL /* Receive CRC error counter */
#define BMAC_RXSMACHINE 0x334UL /* Receiver state machine */
#define BMAC_RXCVALID 0x338UL /* Receiver code violation */
/* 0x33c, reserved */
#define BMAC_HTABLE3 0x340UL /* Hash table 3 */
#define BMAC_HTABLE2 0x344UL /* Hash table 2 */
#define BMAC_HTABLE1 0x348UL /* Hash table 1 */
#define BMAC_HTABLE0 0x34cUL /* Hash table 0 */
#define BMAC_AFILTER2 0x350UL /* Address filter 2 */
#define BMAC_AFILTER1 0x354UL /* Address filter 1 */
#define BMAC_AFILTER0 0x358UL /* Address filter 0 */
#define BMAC_AFMASK 0x35cUL /* Address filter mask */
#define BMAC_REG_SIZE 0x360UL
/* BigMac XIF config register. */
#define BIGMAC_XCFG_ODENABLE 0x00000001 /* Output driver enable */
#define BIGMAC_XCFG_XLBACK 0x00000002 /* Loopback-mode XIF enable */
#define BIGMAC_XCFG_MLBACK 0x00000004 /* Loopback-mode MII enable */
#define BIGMAC_XCFG_MIIDISAB 0x00000008 /* MII receive buffer disable */
#define BIGMAC_XCFG_SQENABLE 0x00000010 /* SQE test enable */
#define BIGMAC_XCFG_SQETWIN 0x000003e0 /* SQE time window */
#define BIGMAC_XCFG_LANCE 0x00000010 /* Lance mode enable */
#define BIGMAC_XCFG_LIPG0 0x000003e0 /* Lance mode IPG0 */
/* BigMac transmit config register. */
#define BIGMAC_TXCFG_ENABLE 0x00000001 /* Enable the transmitter */
#define BIGMAC_TXCFG_SMODE 0x00000020 /* Enable slow transmit mode */
#define BIGMAC_TXCFG_CIGN 0x00000040 /* Ignore transmit collisions */
#define BIGMAC_TXCFG_FCSOFF 0x00000080 /* Do not emit FCS */
#define BIGMAC_TXCFG_DBACKOFF 0x00000100 /* Disable backoff */
#define BIGMAC_TXCFG_FULLDPLX 0x00000200 /* Enable full-duplex */
#define BIGMAC_TXCFG_DGIVEUP 0x00000400 /* Don't give up on transmits */
/* BigMac receive config register. */
#define BIGMAC_RXCFG_ENABLE 0x00000001 /* Enable the receiver */
#define BIGMAC_RXCFG_PSTRIP 0x00000020 /* Pad byte strip enable */
#define BIGMAC_RXCFG_PMISC 0x00000040 /* Enable promiscuous mode */
#define BIGMAC_RXCFG_DERR 0x00000080 /* Disable error checking */
#define BIGMAC_RXCFG_DCRCS 0x00000100 /* Disable CRC stripping */
#define BIGMAC_RXCFG_REJME 0x00000200 /* Reject packets addressed to me */
#define BIGMAC_RXCFG_PGRP 0x00000400 /* Enable promisc group mode */
#define BIGMAC_RXCFG_HENABLE 0x00000800 /* Enable the hash filter */
#define BIGMAC_RXCFG_AENABLE 0x00001000 /* Enable the address filter */
/* These are the "Management Interface" (ie. MIF) registers of the transceiver. */
#define TCVR_BBCLOCK 0x00UL /* Bit bang clock register */
#define TCVR_BBDATA 0x04UL /* Bit bang data register */
#define TCVR_BBOENAB 0x08UL /* Bit bang output enable */
#define TCVR_FRAME 0x0cUL /* Frame control/data register */
#define TCVR_CFG 0x10UL /* MIF config register */
#define TCVR_IMASK 0x14UL /* MIF interrupt mask */
#define TCVR_STATUS 0x18UL /* MIF status */
#define TCVR_SMACHINE 0x1cUL /* MIF state machine */
#define TCVR_REG_SIZE 0x20UL
/* Frame commands. */
#define FRAME_WRITE 0x50020000
#define FRAME_READ 0x60020000
/* Transceiver config register */
#define TCV_CFG_PSELECT 0x00000001 /* Select PHY */
#define TCV_CFG_PENABLE 0x00000002 /* Enable MIF polling */
#define TCV_CFG_BENABLE 0x00000004 /* Enable the "bit banger" oh baby */
#define TCV_CFG_PREGADDR 0x000000f8 /* Address of poll register */
#define TCV_CFG_MDIO0 0x00000100 /* MDIO zero, data/attached */
#define TCV_CFG_MDIO1 0x00000200 /* MDIO one, data/attached */
#define TCV_CFG_PDADDR 0x00007c00 /* Device PHY address polling */
/* Here are some PHY addresses. */
#define TCV_PADDR_ETX 0 /* Internal transceiver */
#define TCV_PADDR_ITX 1 /* External transceiver */
/* Transceiver status register */
#define TCV_STAT_BASIC 0xffff0000 /* The "basic" part */
#define TCV_STAT_NORMAL 0x0000ffff /* The "non-basic" part */
/* Inside the Happy Meal transceiver is the physical layer, they use an
* implementations for National Semiconductor, part number DP83840VCE.
* You can retrieve the data sheets and programming docs for this beast
* from http://www.national.com/
*
* The DP83840 is capable of both 10 and 100Mbps ethernet, in both
* half and full duplex mode. It also supports auto negotiation.
*
* But.... THIS THING IS A PAIN IN THE ASS TO PROGRAM!
* Debugging eeprom burnt code is more fun than programming this chip!
*/
/* Generic MII registers defined in linux/mii.h, these below
* are DP83840 specific.
*/
#define DP83840_CSCONFIG 0x17 /* CS configuration */
/* The Carrier Sense config register. */
#define CSCONFIG_RESV1 0x0001 /* Unused... */
#define CSCONFIG_LED4 0x0002 /* Pin for full-dplx LED4 */
#define CSCONFIG_LED1 0x0004 /* Pin for conn-status LED1 */
#define CSCONFIG_RESV2 0x0008 /* Unused... */
#define CSCONFIG_TCVDISAB 0x0010 /* Turns off the transceiver */
#define CSCONFIG_DFBYPASS 0x0020 /* Bypass disconnect function */
#define CSCONFIG_GLFORCE 0x0040 /* Good link force for 100mbps */
#define CSCONFIG_CLKTRISTATE 0x0080 /* Tristate 25m clock */
#define CSCONFIG_RESV3 0x0700 /* Unused... */
#define CSCONFIG_ENCODE 0x0800 /* 1=MLT-3, 0=binary */
#define CSCONFIG_RENABLE 0x1000 /* Repeater mode enable */
#define CSCONFIG_TCDISABLE 0x2000 /* Disable timeout counter */
#define CSCONFIG_RESV4 0x4000 /* Unused... */
#define CSCONFIG_NDISABLE 0x8000 /* Disable NRZI */
/* Happy Meal descriptor rings and such.
* All descriptor rings must be aligned on a 2K boundary.
* All receive buffers must be 64 byte aligned.
* Always write the address first before setting the ownership
* bits to avoid races with the hardware scanning the ring.
*/
typedef u32 __bitwise hme32;
struct happy_meal_rxd {
hme32 rx_flags;
hme32 rx_addr;
};
#define RXFLAG_OWN 0x80000000 /* 1 = hardware, 0 = software */
#define RXFLAG_OVERFLOW 0x40000000 /* 1 = buffer overflow */
#define RXFLAG_SIZE 0x3fff0000 /* Size of the buffer */
#define RXFLAG_CSUM 0x0000ffff /* HW computed checksum */
struct happy_meal_txd {
hme32 tx_flags;
hme32 tx_addr;
};
#define TXFLAG_OWN 0x80000000 /* 1 = hardware, 0 = software */
#define TXFLAG_SOP 0x40000000 /* 1 = start of packet */
#define TXFLAG_EOP 0x20000000 /* 1 = end of packet */
#define TXFLAG_CSENABLE 0x10000000 /* 1 = enable hw-checksums */
#define TXFLAG_CSLOCATION 0x0ff00000 /* Where to stick the csum */
#define TXFLAG_CSBUFBEGIN 0x000fc000 /* Where to begin checksum */
#define TXFLAG_SIZE 0x00003fff /* Size of the packet */
#define TX_RING_SIZE 32 /* Must be >16 and <255, multiple of 16 */
#define RX_RING_SIZE 32 /* see ERX_CFG_SIZE* for possible values */
#if (TX_RING_SIZE < 16 || TX_RING_SIZE > 256 || (TX_RING_SIZE % 16) != 0)
#error TX_RING_SIZE holds illegal value
#endif
#define TX_RING_MAXSIZE 256
#define RX_RING_MAXSIZE 256
/* We use a 14 byte offset for checksum computation. */
#if (RX_RING_SIZE == 32)
#define ERX_CFG_DEFAULT(off) (ERX_CFG_DMAENABLE|((off)<<3)|ERX_CFG_SIZE32|((14/2)<<16))
#else
#if (RX_RING_SIZE == 64)
#define ERX_CFG_DEFAULT(off) (ERX_CFG_DMAENABLE|((off)<<3)|ERX_CFG_SIZE64|((14/2)<<16))
#else
#if (RX_RING_SIZE == 128)
#define ERX_CFG_DEFAULT(off) (ERX_CFG_DMAENABLE|((off)<<3)|ERX_CFG_SIZE128|((14/2)<<16))
#else
#if (RX_RING_SIZE == 256)
#define ERX_CFG_DEFAULT(off) (ERX_CFG_DMAENABLE|((off)<<3)|ERX_CFG_SIZE256|((14/2)<<16))
#else
#error RX_RING_SIZE holds illegal value
#endif
#endif
#endif
#endif
#define NEXT_RX(num) (((num) + 1) & (RX_RING_SIZE - 1))
#define NEXT_TX(num) (((num) + 1) & (TX_RING_SIZE - 1))
#define PREV_RX(num) (((num) - 1) & (RX_RING_SIZE - 1))
#define PREV_TX(num) (((num) - 1) & (TX_RING_SIZE - 1))
#define TX_BUFFS_AVAIL(hp) \
(((hp)->tx_old <= (hp)->tx_new) ? \
(hp)->tx_old + (TX_RING_SIZE - 1) - (hp)->tx_new : \
(hp)->tx_old - (hp)->tx_new - 1)
#define RX_OFFSET 2
#define RX_BUF_ALLOC_SIZE (1546 + RX_OFFSET + 64)
#define RX_COPY_THRESHOLD 256
struct hmeal_init_block {
struct happy_meal_rxd happy_meal_rxd[RX_RING_MAXSIZE];
struct happy_meal_txd happy_meal_txd[TX_RING_MAXSIZE];
};
#define hblock_offset(mem, elem) \
((__u32)((unsigned long)(&(((struct hmeal_init_block *)0)->mem[elem]))))
/* Now software state stuff. */
enum happy_transceiver {
external = 0,
internal = 1,
none = 2,
};
/* Timer state engine. */
enum happy_timer_state {
arbwait = 0, /* Waiting for auto negotiation to complete. */
lupwait = 1, /* Auto-neg complete, awaiting link-up status. */
ltrywait = 2, /* Forcing try of all modes, from fastest to slowest. */
asleep = 3, /* Time inactive. */
};
struct quattro;
/* Happy happy, joy joy! */
struct happy_meal {
void __iomem *gregs; /* Happy meal global registers */
struct hmeal_init_block *happy_block; /* RX and TX descriptors (CPU addr) */
#if defined(CONFIG_SBUS) && defined(CONFIG_PCI)
u32 (*read_desc32)(hme32 *);
void (*write_txd)(struct happy_meal_txd *, u32, u32);
void (*write_rxd)(struct happy_meal_rxd *, u32, u32);
#endif
/* This is either an platform_device or a pci_dev. */
void *happy_dev;
struct device *dma_dev;
spinlock_t happy_lock;
struct sk_buff *rx_skbs[RX_RING_SIZE];
struct sk_buff *tx_skbs[TX_RING_SIZE];
int rx_new, tx_new, rx_old, tx_old;
#if defined(CONFIG_SBUS) && defined(CONFIG_PCI)
u32 (*read32)(void __iomem *);
void (*write32)(void __iomem *, u32);
#endif
void __iomem *etxregs; /* External transmitter regs */
void __iomem *erxregs; /* External receiver regs */
void __iomem *bigmacregs; /* BIGMAC core regs */
void __iomem *tcvregs; /* MIF transceiver regs */
dma_addr_t hblock_dvma; /* DVMA visible address happy block */
unsigned int happy_flags; /* Driver state flags */
int irq;
enum happy_transceiver tcvr_type; /* Kind of transceiver in use */
unsigned int happy_bursts; /* Get your mind out of the gutter */
unsigned int paddr; /* PHY address for transceiver */
unsigned short hm_revision; /* Happy meal revision */
unsigned short sw_bmcr; /* SW copy of BMCR */
unsigned short sw_bmsr; /* SW copy of BMSR */
unsigned short sw_physid1; /* SW copy of PHYSID1 */
unsigned short sw_physid2; /* SW copy of PHYSID2 */
unsigned short sw_advertise; /* SW copy of ADVERTISE */
unsigned short sw_lpa; /* SW copy of LPA */
unsigned short sw_expansion; /* SW copy of EXPANSION */
unsigned short sw_csconfig; /* SW copy of CSCONFIG */
unsigned int auto_speed; /* Auto-nego link speed */
unsigned int forced_speed; /* Force mode link speed */
unsigned int poll_data; /* MIF poll data */
unsigned int poll_flag; /* MIF poll flag */
unsigned int linkcheck; /* Have we checked the link yet? */
unsigned int lnkup; /* Is the link up as far as we know? */
unsigned int lnkdown; /* Trying to force the link down? */
unsigned int lnkcnt; /* Counter for link-up attempts. */
struct timer_list happy_timer; /* To watch the link when coming up. */
enum happy_timer_state timer_state; /* State of the auto-neg timer. */
unsigned int timer_ticks; /* Number of clicks at each state. */
struct net_device *dev; /* Backpointer */
struct quattro *qfe_parent; /* For Quattro cards */
int qfe_ent; /* Which instance on quattro */
};
/* Here are the happy flags. */
#define HFLAG_POLL 0x00000001 /* We are doing MIF polling */
#define HFLAG_FENABLE 0x00000002 /* The MII frame is enabled */
#define HFLAG_LANCE 0x00000004 /* We are using lance-mode */
#define HFLAG_RXENABLE 0x00000008 /* Receiver is enabled */
#define HFLAG_AUTO 0x00000010 /* Using auto-negotiation, 0 = force */
#define HFLAG_FULL 0x00000020 /* Full duplex enable */
#define HFLAG_MACFULL 0x00000040 /* Using full duplex in the MAC */
#define HFLAG_POLLENABLE 0x00000080 /* Actually try MIF polling */
#define HFLAG_RXCV 0x00000100 /* XXX RXCV ENABLE */
#define HFLAG_INIT 0x00000200 /* Init called at least once */
#define HFLAG_LINKUP 0x00000400 /* 1 = Link is up */
#define HFLAG_PCI 0x00000800 /* PCI based Happy Meal */
#define HFLAG_QUATTRO 0x00001000 /* On QFE/Quattro card */
#define HFLAG_20_21 (HFLAG_POLLENABLE | HFLAG_FENABLE)
#define HFLAG_NOT_A0 (HFLAG_POLLENABLE | HFLAG_FENABLE | HFLAG_LANCE | HFLAG_RXCV)
/* Support for QFE/Quattro cards. */
struct quattro {
struct net_device *happy_meals[4];
/* This is either a sbus_dev or a pci_dev. */
void *quattro_dev;
struct quattro *next;
/* PROM ranges, if any. */
#ifdef CONFIG_SBUS
struct linux_prom_ranges ranges[8];
#endif
int nranges;
};
/* We use this to acquire receive skb's that we can DMA directly into. */
#define ALIGNED_RX_SKB_ADDR(addr) \
((((unsigned long)(addr) + (64UL - 1UL)) & ~(64UL - 1UL)) - (unsigned long)(addr))
#define happy_meal_alloc_skb(__length, __gfp_flags) \
({ struct sk_buff *__skb; \
__skb = alloc_skb((__length) + 64, (__gfp_flags)); \
if(__skb) { \
int __offset = (int) ALIGNED_RX_SKB_ADDR(__skb->data); \
if(__offset) \
skb_reserve(__skb, __offset); \
} \
__skb; \
})
#endif /* !(_SUNHME_H) */