xref: /freebsd/sys/dev/e1000/e1000_phy.h (revision 2e3507c25e42292b45a5482e116d278f5515d04d)
1 /******************************************************************************
2   SPDX-License-Identifier: BSD-3-Clause
3 
4   Copyright (c) 2001-2020, Intel Corporation
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 are met:
9 
10    1. Redistributions of source code must retain the above copyright notice,
11       this list of conditions and the following disclaimer.
12 
13    2. Redistributions in binary form must reproduce the above copyright
14       notice, this list of conditions and the following disclaimer in the
15       documentation and/or other materials provided with the distribution.
16 
17    3. Neither the name of the Intel Corporation nor the names of its
18       contributors may be used to endorse or promote products derived from
19       this software without specific prior written permission.
20 
21   THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
22   AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
23   IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
24   ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
25   LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
26   CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
27   SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
28   INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
29   CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
30   ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
31   POSSIBILITY OF SUCH DAMAGE.
32 
33 ******************************************************************************/
34 
35 #ifndef _E1000_PHY_H_
36 #define _E1000_PHY_H_
37 
38 void e1000_init_phy_ops_generic(struct e1000_hw *hw);
39 s32  e1000_null_read_reg(struct e1000_hw *hw, u32 offset, u16 *data);
40 void e1000_null_phy_generic(struct e1000_hw *hw);
41 s32  e1000_null_lplu_state(struct e1000_hw *hw, bool active);
42 s32  e1000_null_write_reg(struct e1000_hw *hw, u32 offset, u16 data);
43 s32  e1000_null_set_page(struct e1000_hw *hw, u16 data);
44 s32 e1000_read_i2c_byte_null(struct e1000_hw *hw, u8 byte_offset,
45 			     u8 dev_addr, u8 *data);
46 s32 e1000_write_i2c_byte_null(struct e1000_hw *hw, u8 byte_offset,
47 			      u8 dev_addr, u8 data);
48 s32  e1000_check_downshift_generic(struct e1000_hw *hw);
49 s32  e1000_check_polarity_m88(struct e1000_hw *hw);
50 s32  e1000_check_polarity_igp(struct e1000_hw *hw);
51 s32  e1000_check_polarity_ife(struct e1000_hw *hw);
52 s32  e1000_check_reset_block_generic(struct e1000_hw *hw);
53 s32  e1000_phy_setup_autoneg(struct e1000_hw *hw);
54 s32  e1000_copper_link_autoneg(struct e1000_hw *hw);
55 s32  e1000_copper_link_setup_igp(struct e1000_hw *hw);
56 s32  e1000_copper_link_setup_m88(struct e1000_hw *hw);
57 s32  e1000_copper_link_setup_m88_gen2(struct e1000_hw *hw);
58 s32  e1000_phy_force_speed_duplex_igp(struct e1000_hw *hw);
59 s32  e1000_phy_force_speed_duplex_m88(struct e1000_hw *hw);
60 s32  e1000_phy_force_speed_duplex_ife(struct e1000_hw *hw);
61 s32  e1000_get_cable_length_m88(struct e1000_hw *hw);
62 s32  e1000_get_cable_length_m88_gen2(struct e1000_hw *hw);
63 s32  e1000_get_cable_length_igp_2(struct e1000_hw *hw);
64 s32  e1000_get_cfg_done_generic(struct e1000_hw *hw);
65 s32  e1000_get_phy_id(struct e1000_hw *hw);
66 s32  e1000_get_phy_info_igp(struct e1000_hw *hw);
67 s32  e1000_get_phy_info_m88(struct e1000_hw *hw);
68 s32  e1000_get_phy_info_ife(struct e1000_hw *hw);
69 s32  e1000_phy_sw_reset_generic(struct e1000_hw *hw);
70 void e1000_phy_force_speed_duplex_setup(struct e1000_hw *hw, u16 *phy_ctrl);
71 s32  e1000_phy_hw_reset_generic(struct e1000_hw *hw);
72 s32  e1000_phy_reset_dsp_generic(struct e1000_hw *hw);
73 s32  e1000_read_kmrn_reg_generic(struct e1000_hw *hw, u32 offset, u16 *data);
74 s32  e1000_read_kmrn_reg_locked(struct e1000_hw *hw, u32 offset, u16 *data);
75 s32  e1000_set_page_igp(struct e1000_hw *hw, u16 page);
76 s32  e1000_read_phy_reg_igp(struct e1000_hw *hw, u32 offset, u16 *data);
77 s32  e1000_read_phy_reg_igp_locked(struct e1000_hw *hw, u32 offset, u16 *data);
78 s32  e1000_read_phy_reg_m88(struct e1000_hw *hw, u32 offset, u16 *data);
79 s32  e1000_set_d3_lplu_state_generic(struct e1000_hw *hw, bool active);
80 s32  e1000_setup_copper_link_generic(struct e1000_hw *hw);
81 s32  e1000_write_kmrn_reg_generic(struct e1000_hw *hw, u32 offset, u16 data);
82 s32  e1000_write_kmrn_reg_locked(struct e1000_hw *hw, u32 offset, u16 data);
83 s32  e1000_write_phy_reg_igp(struct e1000_hw *hw, u32 offset, u16 data);
84 s32  e1000_write_phy_reg_igp_locked(struct e1000_hw *hw, u32 offset, u16 data);
85 s32  e1000_write_phy_reg_m88(struct e1000_hw *hw, u32 offset, u16 data);
86 s32  e1000_phy_has_link_generic(struct e1000_hw *hw, u32 iterations,
87 				u32 usec_interval, bool *success);
88 s32  e1000_phy_init_script_igp3(struct e1000_hw *hw);
89 enum e1000_phy_type e1000_get_phy_type_from_id(u32 phy_id);
90 s32  e1000_determine_phy_address(struct e1000_hw *hw);
91 s32  e1000_write_phy_reg_bm(struct e1000_hw *hw, u32 offset, u16 data);
92 s32  e1000_read_phy_reg_bm(struct e1000_hw *hw, u32 offset, u16 *data);
93 s32  e1000_enable_phy_wakeup_reg_access_bm(struct e1000_hw *hw, u16 *phy_reg);
94 s32  e1000_disable_phy_wakeup_reg_access_bm(struct e1000_hw *hw, u16 *phy_reg);
95 s32  e1000_read_phy_reg_bm2(struct e1000_hw *hw, u32 offset, u16 *data);
96 s32  e1000_write_phy_reg_bm2(struct e1000_hw *hw, u32 offset, u16 data);
97 void e1000_power_up_phy_copper(struct e1000_hw *hw);
98 void e1000_power_down_phy_copper(struct e1000_hw *hw);
99 s32  e1000_read_phy_reg_mdic(struct e1000_hw *hw, u32 offset, u16 *data);
100 s32  e1000_write_phy_reg_mdic(struct e1000_hw *hw, u32 offset, u16 data);
101 s32  e1000_read_phy_reg_i2c(struct e1000_hw *hw, u32 offset, u16 *data);
102 s32  e1000_write_phy_reg_i2c(struct e1000_hw *hw, u32 offset, u16 data);
103 s32  e1000_read_sfp_data_byte(struct e1000_hw *hw, u16 offset, u8 *data);
104 s32  e1000_write_sfp_data_byte(struct e1000_hw *hw, u16 offset, u8 data);
105 s32  e1000_read_phy_reg_hv(struct e1000_hw *hw, u32 offset, u16 *data);
106 s32  e1000_read_phy_reg_hv_locked(struct e1000_hw *hw, u32 offset, u16 *data);
107 s32  e1000_read_phy_reg_page_hv(struct e1000_hw *hw, u32 offset, u16 *data);
108 s32  e1000_write_phy_reg_hv(struct e1000_hw *hw, u32 offset, u16 data);
109 s32  e1000_write_phy_reg_hv_locked(struct e1000_hw *hw, u32 offset, u16 data);
110 s32  e1000_write_phy_reg_page_hv(struct e1000_hw *hw, u32 offset, u16 data);
111 s32  e1000_link_stall_workaround_hv(struct e1000_hw *hw);
112 s32  e1000_copper_link_setup_82577(struct e1000_hw *hw);
113 s32  e1000_check_polarity_82577(struct e1000_hw *hw);
114 s32  e1000_get_phy_info_82577(struct e1000_hw *hw);
115 s32  e1000_phy_force_speed_duplex_82577(struct e1000_hw *hw);
116 s32  e1000_get_cable_length_82577(struct e1000_hw *hw);
117 s32  e1000_write_phy_reg_gs40g(struct e1000_hw *hw, u32 offset, u16 data);
118 s32  e1000_read_phy_reg_gs40g(struct e1000_hw *hw, u32 offset, u16 *data);
119 s32 e1000_read_phy_reg_mphy(struct e1000_hw *hw, u32 address, u32 *data);
120 s32 e1000_write_phy_reg_mphy(struct e1000_hw *hw, u32 address, u32 data,
121 			     bool line_override);
122 bool e1000_is_mphy_ready(struct e1000_hw *hw);
123 
124 s32 e1000_read_xmdio_reg(struct e1000_hw *hw, u16 addr, u8 dev_addr,
125 			 u16 *data);
126 s32 e1000_write_xmdio_reg(struct e1000_hw *hw, u16 addr, u8 dev_addr,
127 			  u16 data);
128 
129 #define E1000_MAX_PHY_ADDR		8
130 
131 /* IGP01E1000 Specific Registers */
132 #define IGP01E1000_PHY_PORT_CONFIG	0x10 /* Port Config */
133 #define IGP01E1000_PHY_PORT_STATUS	0x11 /* Status */
134 #define IGP01E1000_PHY_PORT_CTRL	0x12 /* Control */
135 #define IGP01E1000_PHY_LINK_HEALTH	0x13 /* PHY Link Health */
136 #define IGP01E1000_GMII_FIFO		0x14 /* GMII FIFO */
137 #define IGP02E1000_PHY_POWER_MGMT	0x19 /* Power Management */
138 #define IGP01E1000_PHY_PAGE_SELECT	0x1F /* Page Select */
139 #define BM_PHY_PAGE_SELECT		22   /* Page Select for BM */
140 #define IGP_PAGE_SHIFT			5
141 #define PHY_REG_MASK			0x1F
142 
143 /* GS40G - I210 PHY defines */
144 #define GS40G_PAGE_SELECT		0x16
145 #define GS40G_PAGE_SHIFT		16
146 #define GS40G_OFFSET_MASK		0xFFFF
147 #define GS40G_PAGE_2			0x20000
148 #define GS40G_MAC_REG2			0x15
149 #define GS40G_MAC_LB			0x4140
150 #define GS40G_MAC_SPEED_1G		0X0006
151 #define GS40G_COPPER_SPEC		0x0010
152 
153 /* BM/HV Specific Registers */
154 #define BM_PORT_CTRL_PAGE		769
155 #define BM_WUC_PAGE			800
156 #define BM_WUC_ADDRESS_OPCODE		0x11
157 #define BM_WUC_DATA_OPCODE		0x12
158 #define BM_WUC_ENABLE_PAGE		BM_PORT_CTRL_PAGE
159 #define BM_WUC_ENABLE_REG		17
160 #define BM_WUC_ENABLE_BIT		(1 << 2)
161 #define BM_WUC_HOST_WU_BIT		(1 << 4)
162 #define BM_WUC_ME_WU_BIT		(1 << 5)
163 
164 #define PHY_UPPER_SHIFT			21
165 #define BM_PHY_REG(page, reg) \
166 	(((reg) & MAX_PHY_REG_ADDRESS) |\
167 	 (((page) & 0xFFFF) << PHY_PAGE_SHIFT) |\
168 	 (((reg) & ~MAX_PHY_REG_ADDRESS) << (PHY_UPPER_SHIFT - PHY_PAGE_SHIFT)))
169 #define BM_PHY_REG_PAGE(offset) \
170 	((u16)(((offset) >> PHY_PAGE_SHIFT) & 0xFFFF))
171 #define BM_PHY_REG_NUM(offset) \
172 	((u16)(((offset) & MAX_PHY_REG_ADDRESS) |\
173 	 (((offset) >> (PHY_UPPER_SHIFT - PHY_PAGE_SHIFT)) &\
174 		~MAX_PHY_REG_ADDRESS)))
175 
176 #define HV_INTC_FC_PAGE_START		768
177 #define I82578_ADDR_REG			29
178 #define I82577_ADDR_REG			16
179 #define I82577_CFG_REG			22
180 #define I82577_CFG_ASSERT_CRS_ON_TX	(1 << 15)
181 #define I82577_CFG_ENABLE_DOWNSHIFT	(3 << 10) /* auto downshift */
182 #define I82577_CTRL_REG			23
183 
184 /* 82577 specific PHY registers */
185 #define I82577_PHY_CTRL_2		18
186 #define I82577_PHY_LBK_CTRL		19
187 #define I82577_PHY_STATUS_2		26
188 #define I82577_PHY_DIAG_STATUS		31
189 
190 /* I82577 PHY Status 2 */
191 #define I82577_PHY_STATUS2_REV_POLARITY		0x0400
192 #define I82577_PHY_STATUS2_MDIX			0x0800
193 #define I82577_PHY_STATUS2_SPEED_MASK		0x0300
194 #define I82577_PHY_STATUS2_SPEED_1000MBPS	0x0200
195 
196 /* I82577 PHY Control 2 */
197 #define I82577_PHY_CTRL2_MANUAL_MDIX		0x0200
198 #define I82577_PHY_CTRL2_AUTO_MDI_MDIX		0x0400
199 #define I82577_PHY_CTRL2_MDIX_CFG_MASK		0x0600
200 
201 /* I82577 PHY Diagnostics Status */
202 #define I82577_DSTATUS_CABLE_LENGTH		0x03FC
203 #define I82577_DSTATUS_CABLE_LENGTH_SHIFT	2
204 
205 /* 82580 PHY Power Management */
206 #define E1000_82580_PHY_POWER_MGMT	0xE14
207 #define E1000_82580_PM_SPD		0x0001 /* Smart Power Down */
208 #define E1000_82580_PM_D0_LPLU		0x0002 /* For D0a states */
209 #define E1000_82580_PM_D3_LPLU		0x0004 /* For all other states */
210 #define E1000_82580_PM_GO_LINKD		0x0020 /* Go Link Disconnect */
211 
212 #define E1000_MPHY_DIS_ACCESS		0x80000000 /* disable_access bit */
213 #define E1000_MPHY_ENA_ACCESS		0x40000000 /* enable_access bit */
214 #define E1000_MPHY_BUSY			0x00010000 /* busy bit */
215 #define E1000_MPHY_ADDRESS_FNC_OVERRIDE	0x20000000 /* fnc_override bit */
216 #define E1000_MPHY_ADDRESS_MASK		0x0000FFFF /* address mask */
217 
218 /* BM PHY Copper Specific Control 1 */
219 #define BM_CS_CTRL1			16
220 
221 /* BM PHY Copper Specific Status */
222 #define BM_CS_STATUS			17
223 #define BM_CS_STATUS_LINK_UP		0x0400
224 #define BM_CS_STATUS_RESOLVED		0x0800
225 #define BM_CS_STATUS_SPEED_MASK		0xC000
226 #define BM_CS_STATUS_SPEED_1000		0x8000
227 
228 /* 82577 Mobile Phy Status Register */
229 #define HV_M_STATUS			26
230 #define HV_M_STATUS_AUTONEG_COMPLETE	0x1000
231 #define HV_M_STATUS_SPEED_MASK		0x0300
232 #define HV_M_STATUS_SPEED_1000		0x0200
233 #define HV_M_STATUS_SPEED_100		0x0100
234 #define HV_M_STATUS_LINK_UP		0x0040
235 
236 #define IGP01E1000_PHY_PCS_INIT_REG	0x00B4
237 #define IGP01E1000_PHY_POLARITY_MASK	0x0078
238 
239 #define IGP01E1000_PSCR_AUTO_MDIX	0x1000
240 #define IGP01E1000_PSCR_FORCE_MDI_MDIX	0x2000 /* 0=MDI, 1=MDIX */
241 
242 #define IGP01E1000_PSCFR_SMART_SPEED	0x0080
243 
244 /* Enable flexible speed on link-up */
245 #define IGP01E1000_GMII_FLEX_SPD	0x0010
246 #define IGP01E1000_GMII_SPD		0x0020 /* Enable SPD */
247 
248 #define IGP02E1000_PM_SPD		0x0001 /* Smart Power Down */
249 #define IGP02E1000_PM_D0_LPLU		0x0002 /* For D0a states */
250 #define IGP02E1000_PM_D3_LPLU		0x0004 /* For all other states */
251 
252 #define IGP01E1000_PLHR_SS_DOWNGRADE	0x8000
253 
254 #define IGP01E1000_PSSR_POLARITY_REVERSED	0x0002
255 #define IGP01E1000_PSSR_MDIX		0x0800
256 #define IGP01E1000_PSSR_SPEED_MASK	0xC000
257 #define IGP01E1000_PSSR_SPEED_1000MBPS	0xC000
258 
259 #define IGP02E1000_PHY_CHANNEL_NUM	4
260 #define IGP02E1000_PHY_AGC_A		0x11B1
261 #define IGP02E1000_PHY_AGC_B		0x12B1
262 #define IGP02E1000_PHY_AGC_C		0x14B1
263 #define IGP02E1000_PHY_AGC_D		0x18B1
264 
265 #define IGP02E1000_AGC_LENGTH_SHIFT	9   /* Course=15:13, Fine=12:9 */
266 #define IGP02E1000_AGC_LENGTH_MASK	0x7F
267 #define IGP02E1000_AGC_RANGE		15
268 
269 #define E1000_CABLE_LENGTH_UNDEFINED	0xFF
270 
271 #define E1000_KMRNCTRLSTA_OFFSET	0x001F0000
272 #define E1000_KMRNCTRLSTA_OFFSET_SHIFT	16
273 #define E1000_KMRNCTRLSTA_REN		0x00200000
274 #define E1000_KMRNCTRLSTA_CTRL_OFFSET	0x1    /* Kumeran Control */
275 #define E1000_KMRNCTRLSTA_DIAG_OFFSET	0x3    /* Kumeran Diagnostic */
276 #define E1000_KMRNCTRLSTA_TIMEOUTS	0x4    /* Kumeran Timeouts */
277 #define E1000_KMRNCTRLSTA_INBAND_PARAM	0x9    /* Kumeran InBand Parameters */
278 #define E1000_KMRNCTRLSTA_IBIST_DISABLE	0x0200 /* Kumeran IBIST Disable */
279 #define E1000_KMRNCTRLSTA_DIAG_NELPBK	0x1000 /* Nearend Loopback mode */
280 #define E1000_KMRNCTRLSTA_K1_CONFIG	0x7
281 #define E1000_KMRNCTRLSTA_K1_ENABLE	0x0002 /* enable K1 */
282 #define E1000_KMRNCTRLSTA_HD_CTRL	0x10   /* Kumeran HD Control */
283 #define E1000_KMRNCTRLSTA_K0S_CTRL	0x1E	/* Kumeran K0s Control */
284 #define E1000_KMRNCTRLSTA_K0S_CTRL_ENTRY_LTNCY_SHIFT	0
285 #define E1000_KMRNCTRLSTA_K0S_CTRL_MIN_TIME_SHIFT	4
286 #define E1000_KMRNCTRLSTA_K0S_CTRL_ENTRY_LTNCY_MASK	\
287 	(3 << E1000_KMRNCTRLSTA_K0S_CTRL_ENTRY_LTNCY_SHIFT)
288 #define E1000_KMRNCTRLSTA_K0S_CTRL_MIN_TIME_MASK \
289 	(7 << E1000_KMRNCTRLSTA_K0S_CTRL_MIN_TIME_SHIFT)
290 
291 #define IFE_PHY_EXTENDED_STATUS_CONTROL	0x10
292 #define IFE_PHY_SPECIAL_CONTROL		0x11 /* 100BaseTx PHY Special Ctrl */
293 #define IFE_PHY_SPECIAL_CONTROL_LED	0x1B /* PHY Special and LED Ctrl */
294 #define IFE_PHY_MDIX_CONTROL		0x1C /* MDI/MDI-X Control */
295 
296 /* IFE PHY Extended Status Control */
297 #define IFE_PESC_POLARITY_REVERSED	0x0100
298 
299 /* IFE PHY Special Control */
300 #define IFE_PSC_AUTO_POLARITY_DISABLE	0x0010
301 #define IFE_PSC_FORCE_POLARITY		0x0020
302 
303 /* IFE PHY Special Control and LED Control */
304 #define IFE_PSCL_PROBE_MODE		0x0020
305 #define IFE_PSCL_PROBE_LEDS_OFF		0x0006 /* Force LEDs 0 and 2 off */
306 #define IFE_PSCL_PROBE_LEDS_ON		0x0007 /* Force LEDs 0 and 2 on */
307 
308 /* IFE PHY MDIX Control */
309 #define IFE_PMC_MDIX_STATUS		0x0020 /* 1=MDI-X, 0=MDI */
310 #define IFE_PMC_FORCE_MDIX		0x0040 /* 1=force MDI-X, 0=force MDI */
311 #define IFE_PMC_AUTO_MDIX		0x0080 /* 1=enable auto, 0=disable */
312 
313 /* SFP modules ID memory locations */
314 #define E1000_SFF_IDENTIFIER_OFFSET	0x00
315 #define E1000_SFF_IDENTIFIER_SFF	0x02
316 #define E1000_SFF_IDENTIFIER_SFP	0x03
317 
318 #define E1000_SFF_ETH_FLAGS_OFFSET	0x06
319 /* Flags for SFP modules compatible with ETH up to 1Gb */
320 struct sfp_e1000_flags {
321 	u8 e1000_base_sx:1;
322 	u8 e1000_base_lx:1;
323 	u8 e1000_base_cx:1;
324 	u8 e1000_base_t:1;
325 	u8 e100_base_lx:1;
326 	u8 e100_base_fx:1;
327 	u8 e10_base_bx10:1;
328 	u8 e10_base_px:1;
329 };
330 
331 /* Vendor OUIs: format of OUI is 0x[byte0][byte1][byte2][00] */
332 #define E1000_SFF_VENDOR_OUI_TYCO	0x00407600
333 #define E1000_SFF_VENDOR_OUI_FTL	0x00906500
334 #define E1000_SFF_VENDOR_OUI_AVAGO	0x00176A00
335 #define E1000_SFF_VENDOR_OUI_INTEL	0x001B2100
336 
337 #endif
338