xref: /netbsd-src/sys/dev/pci/ixgbe/ixgbe_phy.h (revision 6a493d6bc668897c91594964a732d38505b70cbb)
1 /******************************************************************************
2 
3   Copyright (c) 2001-2010, Intel Corporation
4   All rights reserved.
5 
6   Redistribution and use in source and binary forms, with or without
7   modification, are permitted provided that the following conditions are met:
8 
9    1. Redistributions of source code must retain the above copyright notice,
10       this list of conditions and the following disclaimer.
11 
12    2. Redistributions in binary form must reproduce the above copyright
13       notice, this list of conditions and the following disclaimer in the
14       documentation and/or other materials provided with the distribution.
15 
16    3. Neither the name of the Intel Corporation nor the names of its
17       contributors may be used to endorse or promote products derived from
18       this software without specific prior written permission.
19 
20   THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
21   AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
22   IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
23   ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
24   LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
25   CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
26   SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
27   INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
28   CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
29   ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
30   POSSIBILITY OF SUCH DAMAGE.
31 
32 ******************************************************************************/
33 /*$FreeBSD: src/sys/dev/ixgbe/ixgbe_phy.h,v 1.11 2010/11/26 22:46:32 jfv Exp $*/
34 /*$NetBSD: ixgbe_phy.h,v 1.1 2011/08/12 21:55:29 dyoung Exp $*/
35 
36 #ifndef _IXGBE_PHY_H_
37 #define _IXGBE_PHY_H_
38 
39 #include "ixgbe_type.h"
40 #define IXGBE_I2C_EEPROM_DEV_ADDR    0xA0
41 
42 /* EEPROM byte offsets */
43 #define IXGBE_SFF_IDENTIFIER         0x0
44 #define IXGBE_SFF_IDENTIFIER_SFP     0x3
45 #define IXGBE_SFF_VENDOR_OUI_BYTE0   0x25
46 #define IXGBE_SFF_VENDOR_OUI_BYTE1   0x26
47 #define IXGBE_SFF_VENDOR_OUI_BYTE2   0x27
48 #define IXGBE_SFF_1GBE_COMP_CODES    0x6
49 #define IXGBE_SFF_10GBE_COMP_CODES   0x3
50 #define IXGBE_SFF_CABLE_TECHNOLOGY   0x8
51 #define IXGBE_SFF_CABLE_SPEC_COMP    0x3C
52 
53 /* Bitmasks */
54 #define IXGBE_SFF_DA_PASSIVE_CABLE           0x4
55 #define IXGBE_SFF_DA_ACTIVE_CABLE            0x8
56 #define IXGBE_SFF_DA_SPEC_ACTIVE_LIMITING    0x4
57 #define IXGBE_SFF_1GBASESX_CAPABLE           0x1
58 #define IXGBE_SFF_1GBASELX_CAPABLE           0x2
59 #define IXGBE_SFF_1GBASET_CAPABLE            0x8
60 #define IXGBE_SFF_10GBASESR_CAPABLE          0x10
61 #define IXGBE_SFF_10GBASELR_CAPABLE          0x20
62 #define IXGBE_I2C_EEPROM_READ_MASK           0x100
63 #define IXGBE_I2C_EEPROM_STATUS_MASK         0x3
64 #define IXGBE_I2C_EEPROM_STATUS_NO_OPERATION 0x0
65 #define IXGBE_I2C_EEPROM_STATUS_PASS         0x1
66 #define IXGBE_I2C_EEPROM_STATUS_FAIL         0x2
67 #define IXGBE_I2C_EEPROM_STATUS_IN_PROGRESS  0x3
68 
69 /* Flow control defines */
70 #define IXGBE_TAF_SYM_PAUSE                  0x400
71 #define IXGBE_TAF_ASM_PAUSE                  0x800
72 
73 /* Bit-shift macros */
74 #define IXGBE_SFF_VENDOR_OUI_BYTE0_SHIFT    24
75 #define IXGBE_SFF_VENDOR_OUI_BYTE1_SHIFT    16
76 #define IXGBE_SFF_VENDOR_OUI_BYTE2_SHIFT    8
77 
78 /* Vendor OUIs: format of OUI is 0x[byte0][byte1][byte2][00] */
79 #define IXGBE_SFF_VENDOR_OUI_TYCO     0x00407600
80 #define IXGBE_SFF_VENDOR_OUI_FTL      0x00906500
81 #define IXGBE_SFF_VENDOR_OUI_AVAGO    0x00176A00
82 #define IXGBE_SFF_VENDOR_OUI_INTEL    0x001B2100
83 
84 /* I2C SDA and SCL timing parameters for standard mode */
85 #define IXGBE_I2C_T_HD_STA  4
86 #define IXGBE_I2C_T_LOW     5
87 #define IXGBE_I2C_T_HIGH    4
88 #define IXGBE_I2C_T_SU_STA  5
89 #define IXGBE_I2C_T_HD_DATA 5
90 #define IXGBE_I2C_T_SU_DATA 1
91 #define IXGBE_I2C_T_RISE    1
92 #define IXGBE_I2C_T_FALL    1
93 #define IXGBE_I2C_T_SU_STO  4
94 #define IXGBE_I2C_T_BUF     5
95 
96 #define IXGBE_TN_LASI_STATUS_REG        0x9005
97 #define IXGBE_TN_LASI_STATUS_TEMP_ALARM 0x0008
98 
99 s32 ixgbe_init_phy_ops_generic(struct ixgbe_hw *hw);
100 bool ixgbe_validate_phy_addr(struct ixgbe_hw *hw, u32 phy_addr);
101 enum ixgbe_phy_type ixgbe_get_phy_type_from_id(u32 phy_id);
102 s32 ixgbe_get_phy_id(struct ixgbe_hw *hw);
103 s32 ixgbe_identify_phy_generic(struct ixgbe_hw *hw);
104 s32 ixgbe_reset_phy_generic(struct ixgbe_hw *hw);
105 s32 ixgbe_read_phy_reg_generic(struct ixgbe_hw *hw, u32 reg_addr,
106                                u32 device_type, u16 *phy_data);
107 s32 ixgbe_write_phy_reg_generic(struct ixgbe_hw *hw, u32 reg_addr,
108                                 u32 device_type, u16 phy_data);
109 s32 ixgbe_setup_phy_link_generic(struct ixgbe_hw *hw);
110 s32 ixgbe_setup_phy_link_speed_generic(struct ixgbe_hw *hw,
111                                        ixgbe_link_speed speed,
112                                        bool autoneg,
113                                        bool autoneg_wait_to_complete);
114 s32 ixgbe_get_copper_link_capabilities_generic(struct ixgbe_hw *hw,
115                                              ixgbe_link_speed *speed,
116                                              bool *autoneg);
117 
118 /* PHY specific */
119 s32 ixgbe_check_phy_link_tnx(struct ixgbe_hw *hw,
120                              ixgbe_link_speed *speed,
121                              bool *link_up);
122 s32 ixgbe_setup_phy_link_tnx(struct ixgbe_hw *hw);
123 s32 ixgbe_get_phy_firmware_version_tnx(struct ixgbe_hw *hw,
124                                        u16 *firmware_version);
125 s32 ixgbe_get_phy_firmware_version_generic(struct ixgbe_hw *hw,
126                                        u16 *firmware_version);
127 
128 s32 ixgbe_reset_phy_nl(struct ixgbe_hw *hw);
129 s32 ixgbe_identify_sfp_module_generic(struct ixgbe_hw *hw);
130 s32 ixgbe_get_sfp_init_sequence_offsets(struct ixgbe_hw *hw,
131                                         u16 *list_offset,
132                                         u16 *data_offset);
133 s32 ixgbe_tn_check_overtemp(struct ixgbe_hw *hw);
134 s32 ixgbe_read_i2c_byte_generic(struct ixgbe_hw *hw, u8 byte_offset,
135                                 u8 dev_addr, u8 *data);
136 s32 ixgbe_write_i2c_byte_generic(struct ixgbe_hw *hw, u8 byte_offset,
137                                  u8 dev_addr, u8 data);
138 s32 ixgbe_read_i2c_eeprom_generic(struct ixgbe_hw *hw, u8 byte_offset,
139                                   u8 *eeprom_data);
140 s32 ixgbe_write_i2c_eeprom_generic(struct ixgbe_hw *hw, u8 byte_offset,
141                                    u8 eeprom_data);
142 #endif /* _IXGBE_PHY_H_ */
143