/*-
 * SPDX-License-Identifier: BSD-4-Clause
 *
 * Copyright (c) 2004
 *	Bill Paul <wpaul@windriver.com>.   All rights reserved. 
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions
 * are met:
 * 1.  Redistributions of source code must retain the above copyright
 *    notice, this list of conditions and the following disclaimer. 
 * 2.  Redistributions in binary form must reproduce the above copyright
 *    notice, this list of conditions and the following disclaimer in the
 *    documentation and/or other materials provided with the distribution. 
 * 3.  All advertising materials mentioning features or use of this software
 *    must display the following acknowledgement:
 *	This product includes software developed by Bill Paul. 
 * 4.  Neither the name of the author nor the names of any co-contributors
 *    may be used to endorse or promote products derived from this software
 *    without specific prior written permission. 
 *
 * THIS SOFTWARE IS PROVIDED BY Bill Paul AND CONTRIBUTORS ``AS IS'' AND
 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
 * ARE DISCLAIMED.   IN NO EVENT SHALL Bill Paul OR THE VOICES IN HIS HEAD
 * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF
 * THE POSSIBILITY OF SUCH DAMAGE. 
 *
 * $FreeBSD: releng/12.0/sys/dev/mii/ciphyreg.h 325966 2017-11-18 14:26:50Z pfg $
 */

#ifndef _DEV_MII_CIPHYREG_H_
#define	_DEV_MII_CIPHYREG_H_

/*
 * Register definitions for the Cicada CS8201 10/100/1000 gigE copper
 * PHY, embedded within the VIA Networks VT6122 controller. 
 */

/* Command register */
#define CIPHY_MII_BMCR		0x00
#define CIPHY_BMCR_RESET	0x8000
#define CIPHY_BMCR_LOOP		0x4000
#define CIPHY_BMCR_SPD0		0x2000	/* speed select, lower bit */
#define CIPHY_BMCR_AUTOEN	0x1000	/* Autoneg enabled */
#define CIPHY_BMCR_PDOWN	0x0800	/* Power down */
#define CIPHY_BMCR_STARTNEG	0x0200	/* Restart autoneg */
#define CIPHY_BMCR_FDX		0x0100	/* Duplex mode */
#define CIPHY_BMCR_CTEST	0x0080	/* Collision test enable */
#define CIPHY_BMCR_SPD1		0x0040	/* Speed select, upper bit */

#define CIPHY_S1000		CIPHY_BMCR_SPD1	/* 1000mbps */
#define CIPHY_S100		CIPHY_BMCR_SPD0	/* 100mpbs */
#define CIPHY_S10		0		/* 10mbps */

/* Status register */
#define CIPHY_MII_BMSR		0x01
#define CIPHY_BMSR_100T4	0x8000	/* 100 base T4 capable */
#define CIPHY_BMSR_100TXFDX	0x4000	/* 100 base Tx full duplex capable */
#define CIPHY_BMSR_100TXHDX	0x2000	/* 100 base Tx half duplex capable */
#define CIPHY_BMSR_10TFDX	0x1000	/* 10 base T full duplex capable */
#define CIPHY_BMSR_10THDX	0x0800	/* 10 base T half duplex capable */
#define CIPHY_BMSR_100T2FDX	0x0400	/* 100 base T2 full duplex capable */
#define CIPHY_BMSR_100T2HDX	0x0200	/* 100 base T2 half duplex capable */
#define CIPHY_BMSR_EXTSTS	0x0100	/* Extended status present */
#define CIPHY_BMSR_PRESUB	0x0040	/* Preamble surpression */
#define CIPHY_BMSR_ACOMP	0x0020	/* Autoneg complete */
#define CIPHY_BMSR_RFAULT	0x0010	/* Remote fault condition occurred */
#define CIPHY_BMSR_ANEG		0x0008	/* Autoneg capable */
#define CIPHY_BMSR_LINK		0x0004	/* Link status */
#define CIPHY_BMSR_JABBER	0x0002	/* Jabber detected */
#define CIPHY_BMSR_EXT		0x0001	/* Extended capability */

/* PHY ID registers */
#define CIPHY_MII_PHYIDR1	0x02
#define CIPHY_MII_PHYIDR2	0x03

/* Autoneg advertisement */
#define CIPHY_MII_ANAR		0x04
#define CIPHY_ANAR_NP		0x8000	/* Next page */
#define CIPHY_ANAR_RF		0x2000	/* Remote fault */
#define CIPHY_ANAR_ASP		0x0800	/* Asymmetric Pause */
#define CIPHY_ANAR_PC		0x0400	/* Pause capable */
#define CIPHY_ANAR_T4		0x0200	/* local device supports 100bT4 */
#define CIPHY_ANAR_TX_FD	0x0100	/* local device supports 100bTx FD */
#define CIPHY_ANAR_TX		0x0080	/* local device supports 100bTx */
#define CIPHY_ANAR_10_FD	0x0040	/* local device supports 10bT FD */
#define CIPHY_ANAR_10		0x0020	/* local device supports 10bT */
#define CIPHY_ANAR_SEL		0x001F	/* selector field, 00001=Ethernet */

/* Autoneg link partner ability */
#define CIPHY_MII_ANLPAR	0x05
#define CIPHY_ANLPAR_NP		0x8000	/* Next page */
#define CIPHY_ANLPAR_ACK	0x4000	/* link partner acknowledge */
#define CIPHY_ANLPAR_RF		0x2000	/* Remote fault */
#define CIPHY_ANLPAR_ASP	0x0800	/* Asymmetric Pause */
#define CIPHY_ANLPAR_PC		0x0400	/* Pause capable */
#define CIPHY_ANLPAR_T4		0x0200	/* link partner supports 100bT4 */
#define CIPHY_ANLPAR_TX_FD	0x0100	/* link partner supports 100bTx FD */
#define CIPHY_ANLPAR_TX		0x0080	/* link partner supports 100bTx */
#define CIPHY_ANLPAR_10_FD	0x0040	/* link partner supports 10bT FD */
#define CIPHY_ANLPAR_10		0x0020	/* link partner supports 10bT */
#define CIPHY_ANLPAR_SEL	0x001F	/* selector field, 00001=Ethernet */

#define CIPHY_SEL_TYPE		0x0001	/* ethernet */

/* Antoneg expansion register */
#define CIPHY_MII_ANER		0x06
#define CIPHY_ANER_PDF		0x0010	/* Parallel detection fault */
#define CIPHY_ANER_LPNP		0x0008	/* Link partner can next page */
#define CIPHY_ANER_NP		0x0004	/* Local PHY can next page */
#define CIPHY_ANER_RX		0x0002	/* Next page received */
#define CIPHY_ANER_LPAN		0x0001 	/* Link partner autoneg capable */

/* Autoneg next page transmit regisyer */
#define CIPHY_MII_NEXTP		0x07
#define CIPHY_NEXTP_MOREP	0x8000	/* More pages to follow */
#define CIPHY_NEXTP_MESS	0x2000	/* 1 = message page, 0 = unformatted */
#define CIPHY_NEXTP_ACK2	0x1000	/* MAC acknowledge */
#define CIPHY_NEXTP_TOGGLE	0x0800	/* Toggle */
#define CIPHY_NEXTP_CODE	0x07FF	/* Code bits */

/* Autoneg link partner next page receive register */
#define CIPHY_MII_NEXTP_LP	0x08
#define CIPHY_NEXTPLP_MOREP	0x8000	/* More pages to follow */
#define CIPHY_NEXTPLP_MESS	0x2000	/* 1 = message page, 0 = unformatted */
#define CIPHY_NEXTPLP_ACK2	0x1000	/* MAC acknowledge */
#define CIPHY_NEXTPLP_TOGGLE	0x0800	/* Toggle */
#define CIPHY_NEXTPLP_CODE	0x07FF	/* Code bits */

/* 1000BT control register */
#define CIPHY_MII_1000CTL	0x09
#define CIPHY_1000CTL_TST	0xE000	/* test modes */
#define CIPHY_1000CTL_MSE	0x1000	/* Master/Slave manual enable */
#define CIPHY_1000CTL_MSC	0x0800	/* Master/Slave select */
#define CIPHY_1000CTL_RD	0x0400	/* Repeater/DTE */
#define CIPHY_1000CTL_AFD	0x0200	/* Advertise full duplex */
#define CIPHY_1000CTL_AHD	0x0100	/* Advertise half duplex */

#define CIPHY_TEST_TX_JITTER			0x2000
#define CIPHY_TEST_TX_JITTER_MASTER_MODE	0x4000
#define CIPHY_TEST_TX_JITTER_SLAVE_MODE		0x6000
#define CIPHY_TEST_TX_DISTORTION		0x8000

/* 1000BT status register */
#define CIPHY_MII_1000STS	0x0A
#define CIPHY_1000STS_MSF	0x8000	/* Master/slave fault */
#define CIPHY_1000STS_MSR	0x4000	/* Master/slave result */
#define CIPHY_1000STS_LRS	0x2000	/* Local receiver status */
#define CIPHY_1000STS_RRS	0x1000	/* Remote receiver status */
#define CIPHY_1000STS_LPFD	0x0800	/* Link partner can FD */
#define CIPHY_1000STS_LPHD	0x0400	/* Link partner can HD */
#define CIPHY_1000STS_IEC	0x00FF	/* Idle error count */

#define CIPHY_MII_EXTSTS	0x0F	/* Extended status */
#define CIPHY_EXTSTS_X_FD_CAP	0x8000	/* 1000base-X FD capable */
#define CIPHY_EXTSTS_X_HD_CAP	0x4000	/* 1000base-X HD capable */
#define CIPHY_EXTSTS_T_FD_CAP	0x2000	/* 1000base-T FD capable */
#define CIPHY_EXTSTS_T_HD_CAP	0x1000	/* 1000base-T HD capable */

/* 1000BT status extension register #1 */
#define CIPHY_MII_1000STS1	0x0F
#define CIPHY_1000STS1_1000XFDX	0x8000	/* 1000baseX FDX capable */
#define CIPHY_1000STS1_1000XHDX	0x4000	/* 1000baseX HDX capable */
#define CIPHY_1000STS1_1000TFDX	0x2000	/* 1000baseT FDX capable */
#define CIPHY_1000STS1_1000THDX	0x1000	/* 1000baseT HDX capable */

/* Vendor-specific PHY registers */

/* 100baseTX status extension register */
#define CIPHY_MII_100STS	0x10
#define CIPHY_100STS_DESLCK	0x8000	/* descrambler locked */
#define CIPHY_100STS_LKCERR	0x4000	/* lock error detected/lock lost */
#define CIPHY_100STS_DISC	0x2000	/* disconnect state */
#define CIPHY_100STS_LINK	0x1000	/* current link state */
#define CIPHY_100STS_RXERR	0x0800	/* receive error detected */
#define CIPHY_100STS_TXERR	0x0400	/* transmit error detected */
#define CIPHY_100STS_SSDERR	0x0200	/* false carrier error detected */
#define CIPHY_100STS_ESDERR	0x0100	/* premature end of stream error */

/* 1000BT status extension register #2 */
#define CIPHY_MII_1000STS2	0x11
#define CIPHY_1000STS2_DESLCK	0x8000	/* descrambler locked */
#define CIPHY_1000STS2_LKCERR	0x4000	/* lock error detected/lock lost */
#define CIPHY_1000STS2_DISC	0x2000	/* disconnect state */
#define CIPHY_1000STS2_LINK	0x1000	/* current link state */
#define CIPHY_1000STS2_RXERR	0x0800	/* receive error detected */
#define CIPHY_1000STS2_TXERR	0x0400	/* transmit error detected */
#define CIPHY_1000STS2_SSDERR	0x0200	/* false carrier error detected */
#define CIPHY_1000STS2_ESDERR	0x0100	/* premature end of stream error */
#define CIPHY_1000STS2_CARREXT	0x0080	/* carrier extension err detected */
#define CIPHY_1000STS2_BCM5400	0x0040	/* non-complient BCM5400 detected */

/* Bypass control register */
#define CIPHY_MII_BYPASS	0x12
#define CIPHY_BYPASS_TX		0x8000	/* transmit disable */
#define CIPHY_BYPASS_4B5B	0x4000	/* bypass the 4B5B encoder */
#define CIPHY_BYPASS_SCRAM	0x2000	/* bypass scrambler */
#define CIPHY_BYPASS_DSCAM	0x1000	/* bypass descrambler */
#define CIPHY_BYPASS_PCSRX	0x0800	/* bypass PCS receive */
#define CIPHY_BYPASS_PCSTX	0x0400	/* bypass PCS transmit */
#define CIPHY_BYPASS_LFI	0x0200	/* bypass LFI timer */
#define CIPHY_BYPASS_TXCLK	0x0100	/* enable transmit clock on LED4 pin */
#define CIPHY_BYPASS_BCM5400_F	0x0080	/* force BCM5400 detect */
#define CIPHY_BYPASS_BCM5400	0x0040	/* bypass BCM5400 detect */
#define CIPHY_BYPASS_PAIRSWAP	0x0020	/* disable automatic pair swap */
#define CIPHY_BYPASS_POLARITY	0x0010	/* disable polarity correction */
#define CIPHY_BYPASS_PARALLEL	0x0008	/* parallel detect enable */
#define CIPHY_BYPASS_PULSE	0x0004	/* disable pulse shaping filter */
#define CIPHY_BYPASS_1000BNP	0x0002	/* disable 1000BT next page exchange */

/* RX error count register */
#define CIPHY_MII_RXERR		0x13

/* False carrier sense count register */
#define CIPHY_MII_FCSERR	0x14

/* Ddisconnect error counter */
#define CIPHY_MII_DISCERR	0x15

/* 10baseT control/status register */
#define CIPHY_MII_10BTCSR	0x16
#define CIPHY_10BTCSR_DLIT	0x8000	/* Disable data link integrity test */
#define CIPHY_10BTCSR_JABBER	0x4000	/* Disable jabber detect */
#define CIPHY_10BTCSR_ECHO	0x2000	/* Disable echo mode */
#define CIPHY_10BTCSR_SQE	0x1000	/* Disable signal quality error */
#define CIPHY_10BTCSR_SQUENCH	0x0C00	/* Squelch control */
#define CIPHY_10BTCSR_EOFERR	0x0100	/* End of Frame error */
#define CIPHY_10BTCSR_DISC	0x0080	/* Disconnect status */
#define CIPHY_10BTCSR_LINK	0x0040	/* current link state */
#define CIPHY_10BTCSR_ITRIM	0x0038	/* current reference trim */
#define CIPHY_10BTCSR_CSR	0x0006	/* CSR behavior control */

#define CIPHY_SQUELCH_300MV	0x0000
#define CIPHY_SQUELCH_197MV	0x0400
#define CIPHY_SQUELCH_450MV	0x0800
#define CIPHY_SQUELCH_RSVD	0x0C00

#define CIPHY_ITRIM_PLUS2	0x0000
#define CIPHY_ITRIM_PLUS4	0x0008
#define CIPHY_ITRIM_PLUS6	0x0010
#define CIPHY_ITRIM_PLUS6_	0x0018
#define CIPHY_ITRIM_MINUS4	0x0020
#define CIPHY_ITRIM_MINUS4_	0x0028
#define CIPHY_ITRIM_MINUS2	0x0030
#define CIPHY_ITRIM_ZERO	0x0038

/* Extended PHY control register #1 */
#define CIPHY_MII_ECTL1		0x17
#define CIPHY_ECTL1_ACTIPHY	0x0020	/* Enable ActiPHY power saving */
#define CIPHY_ECTL1_IOVOL	0x0e00	/* MAC interface and I/O voltage select */
#define CIPHY_ECTL1_INTSEL	0xf000	/* select MAC interface */

#define CIPHY_IOVOL_3300MV	0x0000	/* 3.3V for I/O pins */
#define CIPHY_IOVOL_2500MV	0x0200	/* 2.5V for I/O pins */

#define CIPHY_INTSEL_GMII	0x0000	/* GMII/MII */
#define CIPHY_INTSEL_RGMII	0x1000
#define CIPHY_INTSEL_TBI	0x2000
#define CIPHY_INTSEL_RTBI	0x3000

/* Extended PHY control register #2 */
#define CIPHY_MII_ECTL2		0x18
#define CIPHY_ECTL2_ERATE	0xE000	/* 10/1000 edge rate control */
#define CIPHY_ECTL2_VTRIM	0x1C00	/* voltage reference trim */
#define CIPHY_ECTL2_CABLELEN	0x000E	/* Cable quality/length */
#define CIPHY_ECTL2_ANALOGLOOP	0x0001	/* 1000BT analog loopback */

#define CIPHY_CABLELEN_0TO10M		0x0000
#define CIPHY_CABLELEN_10TO20M		0x0002
#define CIPHY_CABLELEN_20TO40M		0x0004
#define CIPHY_CABLELEN_40TO80M		0x0006
#define CIPHY_CABLELEN_80TO100M		0x0008
#define CIPHY_CABLELEN_100TO140M	0x000A
#define CIPHY_CABLELEN_140TO180M	0x000C
#define CIPHY_CABLELEN_OVER180M		0x000E

/* Interrupt mask register */
#define CIPHY_MII_IMR		0x19
#define CIPHY_IMR_PINENABLE	0x8000	/* Interrupt pin enable */
#define CIPHY_IMR_SPEED		0x4000	/* speed changed event */
#define CIPHY_IMR_LINK		0x2000	/* link change/ActiPHY event */
#define CIPHY_IMR_DPX		0x1000	/* duplex change event */
#define CIPHY_IMR_ANEGERR	0x0800	/* autoneg error event */
#define CIPHY_IMR_ANEGDONE	0x0400	/* autoneg done event */
#define CIPHY_IMR_NPRX		0x0200	/* page received event */
#define CIPHY_IMR_SYMERR	0x0100	/* symbol error event */
#define CIPHY_IMR_LOCKERR	0x0080	/* descrambler lock lost event */
#define CIPHY_IMR_XOVER		0x0040	/* MDI crossover change event */
#define CIPHY_IMR_POLARITY	0x0020	/* polarity change event */
#define CIPHY_IMR_JABBER	0x0010	/* jabber detect event */
#define CIPHY_IMR_SSDERR	0x0008	/* false carrier detect event */
#define CIPHY_IMR_ESDERR	0x0004	/* parallel detect error event */
#define CIPHY_IMR_MASTERSLAVE	0x0002	/* master/slave resolve done event */
#define CIPHY_IMR_RXERR		0x0001	/* RX error event */

/* Interrupt status register */
#define CIPHY_MII_ISR		0x1A
#define CIPHY_ISR_IPENDING	0x8000	/* Interrupt is pending */
#define CIPHY_ISR_SPEED		0x4000	/* speed changed event */
#define CIPHY_ISR_LINK		0x2000	/* link change/ActiPHY event */
#define CIPHY_ISR_DPX		0x1000	/* duplex change event */
#define CIPHY_ISR_ANEGERR	0x0800	/* autoneg error event */
#define CIPHY_ISR_ANEGDONE	0x0400	/* autoneg done event */
#define CIPHY_ISR_NPRX		0x0200	/* page received event */
#define CIPHY_ISR_SYMERR	0x0100	/* symbol error event */
#define CIPHY_ISR_LOCKERR	0x0080	/* descrambler lock lost event */
#define CIPHY_ISR_XOVER		0x0040	/* MDI crossover change event */
#define CIPHY_ISR_POLARITY	0x0020	/* polarity change event */
#define CIPHY_ISR_JABBER	0x0010	/* jabber detect event */
#define CIPHY_ISR_SSDERR	0x0008	/* false carrier detect event */
#define CIPHY_ISR_ESDERR	0x0004	/* parallel detect error event */
#define CIPHY_ISR_MASTERSLAVE	0x0002	/* master/slave resolve done event */
#define CIPHY_ISR_RXERR		0x0001	/* RX error event */

/* LED control register */
#define CIPHY_MII_LED		0x1B
#define CIPHY_LED_LINK10FORCE	0x8000	/* Force on link10 LED */
#define CIPHY_LED_LINK10DIS	0x4000	/* Disable link10 LED */
#define CIPHY_LED_LINK100FORCE	0x2000	/* Force on link10 LED */
#define CIPHY_LED_LINK100DIS	0x1000	/* Disable link100 LED */
#define CIPHY_LED_LINK1000FORCE	0x0800	/* Force on link1000 LED */
#define CIPHY_LED_LINK1000DIS	0x0400	/* Disable link1000 LED */
#define CIPHY_LED_FDXFORCE	0x0200	/* Force on duplex LED */
#define CIPHY_LED_FDXDIS	0x0100	/* Disable duplex LED */
#define CIPHY_LED_ACTFORCE	0x0080	/* Force on activity LED */
#define CIPHY_LED_ACTDIS	0x0040	/* Disable activity LED */
#define CIPHY_LED_PULSE		0x0008	/* LED pulse enable */
#define CIPHY_LED_LINKACTBLINK	0x0004	/* enable link/activity LED blink */
#define CIPHY_LED_BLINKRATE	0x0002	/* blink rate 0=10hz, 1=5hz */

/* Auxiliary control and status register */
#define CIPHY_MII_AUXCSR	0x1C
#define CIPHY_AUXCSR_ANEGDONE	0x8000	/* Autoneg complete */
#define CIPHY_AUXCSR_ANEGOFF	0x4000	/* Autoneg disabled */
#define CIPHY_AUXCSR_XOVER	0x2000	/* MDI/MDI-X crossover indication */
#define CIPHY_AUXCSR_PAIRSWAP	0x1000	/* pair swap indication */
#define CIPHY_AUXCSR_APOLARITY	0x0800	/* polarity inversion pair A */
#define CIPHY_AUXCSR_BPOLARITY	0x0400	/* polarity inversion pair B */
#define CIPHY_AUXCSR_CPOLARITY	0x0200	/* polarity inversion pair C */
#define CIPHY_AUXCSR_DPOLARITY	0x0100	/* polarity inversion pair D */
#define CIPHY_AUXCSR_FDX	0x0020	/* duplex 1=full, 0=half */
#define CIPHY_AUXCSR_SPEED	0x0018	/* speed */
#define CIPHY_AUXCSR_MDPPS	0x0004	/* No idea, not documented */
#define CIPHY_AUXCSR_STICKYREST 0x0002	/* reset clears sticky bits */

#define CIPHY_SPEED10		0x0000
#define CIPHY_SPEED100		0x0008
#define CIPHY_SPEED1000		0x0010

/* Delay skew status register */
#define CIPHY_MII_DSKEW		0x1D
#define CIPHY_DSKEW_PAIRA	0x7000	/* Pair A skew in symbol times */
#define CIPHY_DSKEW_PAIRB	0x0700	/* Pair B skew in symbol times */
#define CIPHY_DSKEW_PAIRC	0x0070	/* Pair C skew in symbol times */
#define CIPHY_DSKEW_PAIRD	0x0007	/* Pair D skew in symbol times */

#endif /* _DEV_CIPHY_MIIREG_H_ */
