xref: /openbsd/sys/dev/pci/igc_phy.h (revision 3b70601b)
1 /*	$OpenBSD: igc_phy.h,v 1.3 2024/06/09 05:18:12 jsg Exp $	*/
2 /*-
3  * Copyright 2021 Intel Corp
4  * Copyright 2021 Rubicon Communications, LLC (Netgate)
5  * SPDX-License-Identifier: BSD-3-Clause
6  *
7  * $FreeBSD$
8  */
9 
10 #ifndef _IGC_PHY_H_
11 #define _IGC_PHY_H_
12 
13 void	igc_init_phy_ops_generic(struct igc_hw *);
14 int	igc_null_read_reg(struct igc_hw *, uint32_t, uint16_t *);
15 void	igc_null_phy_generic(struct igc_hw *);
16 int	igc_null_lplu_state(struct igc_hw *, bool);
17 int	igc_null_write_reg(struct igc_hw *, uint32_t, uint16_t);
18 int	igc_null_set_page(struct igc_hw *, uint16_t);
19 int	igc_check_downshift_generic(struct igc_hw *);
20 int	igc_check_reset_block_generic(struct igc_hw *);
21 int	igc_get_phy_id(struct igc_hw *);
22 int	igc_phy_hw_reset_generic(struct igc_hw *);
23 int	igc_setup_copper_link_generic(struct igc_hw *);
24 int	igc_phy_has_link_generic(struct igc_hw *, uint32_t, uint32_t, bool *);
25 void	igc_power_up_phy_copper(struct igc_hw *);
26 void	igc_power_down_phy_copper(struct igc_hw *);
27 int	igc_read_phy_reg_mdic(struct igc_hw *, uint32_t offset, uint16_t *);
28 int	igc_write_phy_reg_mdic(struct igc_hw *, uint32_t offset, uint16_t);
29 int	igc_read_xmdio_reg(struct igc_hw *, uint16_t, uint8_t, uint16_t *);
30 int	igc_write_xmdio_reg(struct igc_hw *, uint16_t, uint8_t, uint16_t);
31 int	igc_write_phy_reg_gpy(struct igc_hw *, uint32_t, uint16_t);
32 int	igc_read_phy_reg_gpy(struct igc_hw *, uint32_t, uint16_t *);
33 int	igc_wait_autoneg(struct igc_hw *);
34 
35 /* IGP01IGC Specific Registers */
36 #define IGP01IGC_PHY_PORT_CONFIG	0x10 /* Port Config */
37 #define IGP01IGC_PHY_PORT_STATUS	0x11 /* Status */
38 #define IGP01IGC_PHY_PORT_CTRL		0x12 /* Control */
39 #define IGP01IGC_PHY_LINK_HEALTH	0x13 /* PHY Link Health */
40 #define IGP02IGC_PHY_POWER_MGMT		0x19 /* Power Management */
41 #define IGP01IGC_PHY_PAGE_SELECT	0x1F /* Page Select */
42 #define BM_PHY_PAGE_SELECT		22   /* Page Select for BM */
43 #define IGP_PAGE_SHIFT			5
44 #define PHY_REG_MASK			0x1F
45 #define IGC_I225_PHPM			0x0E14 /* I225 PHY Power Management */
46 #define IGC_I225_PHPM_DIS_1000_D3	0x0008 /* Disable 1G in D3 */
47 #define IGC_I225_PHPM_LINK_ENERGY	0x0010 /* Link Energy Detect */
48 #define IGC_I225_PHPM_GO_LINKD		0x0020 /* Go Link Disconnect */
49 #define IGC_I225_PHPM_DIS_1000		0x0040 /* Disable 1G globally */
50 #define IGC_I225_PHPM_SPD_B2B_EN	0x0080 /* Smart Power Down Back2Back */
51 #define IGC_I225_PHPM_RST_COMPL		0x0100 /* PHY Reset Completed */
52 #define IGC_I225_PHPM_DIS_100_D3	0x0200 /* Disable 100M in D3 */
53 #define IGC_I225_PHPM_ULP		0x0400 /* Ultra Low-Power Mode */
54 #define IGC_I225_PHPM_DIS_2500		0x0800 /* Disable 2.5G globally */
55 #define IGC_I225_PHPM_DIS_2500_D3	0x1000 /* Disable 2.5G in D3 */
56 /* GPY211 - I225 defines */
57 #define GPY_MMD_MASK			0xFFFF0000
58 #define GPY_MMD_SHIFT			16
59 #define GPY_REG_MASK			0x0000FFFF
60 #define IGP01IGC_PHY_PCS_INIT_REG	0x00B4
61 #define IGP01IGC_PHY_POLARITY_MASK	0x0078
62 
63 #define IGP01IGC_PSCR_AUTO_MDIX	0x1000
64 #define IGP01IGC_PSCR_FORCE_MDI_MDIX	0x2000 /* 0=MDI, 1=MDIX */
65 
66 #define IGP01IGC_PSCFR_SMART_SPEED	0x0080
67 
68 #define IGP02IGC_PM_SPD			0x0001 /* Smart Power Down */
69 #define IGP02IGC_PM_D0_LPLU		0x0002 /* For D0a states */
70 #define IGP02IGC_PM_D3_LPLU		0x0004 /* For all other states */
71 
72 #define IGP01IGC_PLHR_SS_DOWNGRADE	0x8000
73 
74 #define IGP01IGC_PSSR_POLARITY_REVERSED	0x0002
75 #define IGP01IGC_PSSR_MDIX		0x0800
76 #define IGP01IGC_PSSR_SPEED_MASK	0xC000
77 #define IGP01IGC_PSSR_SPEED_1000MBPS	0xC000
78 
79 #define IGP02IGC_PHY_CHANNEL_NUM	4
80 #define IGP02IGC_PHY_AGC_A		0x11B1
81 #define IGP02IGC_PHY_AGC_B		0x12B1
82 #define IGP02IGC_PHY_AGC_C		0x14B1
83 #define IGP02IGC_PHY_AGC_D		0x18B1
84 
85 #define IGP02IGC_AGC_LENGTH_SHIFT	9	/* Course=15:13, Fine=12:9 */
86 #define IGP02IGC_AGC_LENGTH_MASK	0x7F
87 #define IGP02IGC_AGC_RANGE		15
88 
89 #define IGC_CABLE_LENGTH_UNDEFINED	0xFF
90 
91 #define IGC_KMRNCTRLSTA_OFFSET		0x001F0000
92 #define IGC_KMRNCTRLSTA_OFFSET_SHIFT	16
93 #define IGC_KMRNCTRLSTA_REN		0x00200000
94 #define IGC_KMRNCTRLSTA_DIAG_OFFSET	0x3    /* Kumeran Diagnostic */
95 #define IGC_KMRNCTRLSTA_TIMEOUTS	0x4    /* Kumeran Timeouts */
96 #define IGC_KMRNCTRLSTA_INBAND_PARAM	0x9    /* Kumeran InBand Parameters */
97 #define IGC_KMRNCTRLSTA_IBIST_DISABLE	0x0200 /* Kumeran IBIST Disable */
98 #define IGC_KMRNCTRLSTA_DIAG_NELPBK	0x1000 /* Nearend Loopback mode */
99 
100 #define IFE_PHY_EXTENDED_STATUS_CONTROL	0x10
101 #define IFE_PHY_SPECIAL_CONTROL		0x11 /* 100BaseTx PHY Special Ctrl */
102 #define IFE_PHY_SPECIAL_CONTROL_LED	0x1B /* PHY Special and LED Ctrl */
103 #define IFE_PHY_MDIX_CONTROL		0x1C /* MDI/MDI-X Control */
104 
105 /* IFE PHY Extended Status Control */
106 #define IFE_PESC_POLARITY_REVERSED	0x0100
107 
108 /* IFE PHY Special Control */
109 #define IFE_PSC_AUTO_POLARITY_DISABLE	0x0010
110 #define IFE_PSC_FORCE_POLARITY		0x0020
111 
112 /* IFE PHY Special Control and LED Control */
113 #define IFE_PSCL_PROBE_MODE		0x0020
114 #define IFE_PSCL_PROBE_LEDS_OFF		0x0006 /* Force LEDs 0 and 2 off */
115 #define IFE_PSCL_PROBE_LEDS_ON		0x0007 /* Force LEDs 0 and 2 on */
116 
117 /* IFE PHY MDIX Control */
118 #define IFE_PMC_MDIX_STATUS		0x0020 /* 1=MDI-X, 0=MDI */
119 #define IFE_PMC_FORCE_MDIX		0x0040 /* 1=force MDI-X, 0=force MDI */
120 #define IFE_PMC_AUTO_MDIX		0x0080 /* 1=enable auto, 0=disable */
121 
122 #endif	/* _IGC_PHY_H_ */
123