diff options
Diffstat (limited to 'src/vendorcode/cavium/include/bdk/libbdk-hal/bdk-mdio.h')
-rw-r--r-- | src/vendorcode/cavium/include/bdk/libbdk-hal/bdk-mdio.h | 476 |
1 files changed, 476 insertions, 0 deletions
diff --git a/src/vendorcode/cavium/include/bdk/libbdk-hal/bdk-mdio.h b/src/vendorcode/cavium/include/bdk/libbdk-hal/bdk-mdio.h new file mode 100644 index 0000000000..889f8d5d56 --- /dev/null +++ b/src/vendorcode/cavium/include/bdk/libbdk-hal/bdk-mdio.h @@ -0,0 +1,476 @@ +/***********************license start*********************************** +* Copyright (c) 2003-2017 Cavium Inc. (support@cavium.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: +* +* * Redistributions of source code must retain the above copyright +* notice, this list of conditions and the following disclaimer. +* +* * 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. +* +* * Neither the name of Cavium Inc. nor the names of +* its contributors may be used to endorse or promote products +* derived from this software without specific prior written +* permission. +* +* This Software, including technical data, may be subject to U.S. export +* control laws, including the U.S. Export Administration Act and its +* associated regulations, and may be subject to export or import +* regulations in other countries. +* +* TO THE MAXIMUM EXTENT PERMITTED BY LAW, THE SOFTWARE IS PROVIDED "AS IS" +* AND WITH ALL FAULTS AND CAVIUM INC. MAKES NO PROMISES, REPRESENTATIONS OR +* WARRANTIES, EITHER EXPRESS, IMPLIED, STATUTORY, OR OTHERWISE, WITH RESPECT +* TO THE SOFTWARE, INCLUDING ITS CONDITION, ITS CONFORMITY TO ANY +* REPRESENTATION OR DESCRIPTION, OR THE EXISTENCE OF ANY LATENT OR PATENT +* DEFECTS, AND CAVIUM SPECIFICALLY DISCLAIMS ALL IMPLIED (IF ANY) WARRANTIES +* OF TITLE, MERCHANTABILITY, NONINFRINGEMENT, FITNESS FOR A PARTICULAR +* PURPOSE, LACK OF VIRUSES, ACCURACY OR COMPLETENESS, QUIET ENJOYMENT, +* QUIET POSSESSION OR CORRESPONDENCE TO DESCRIPTION. THE ENTIRE RISK +* ARISING OUT OF USE OR PERFORMANCE OF THE SOFTWARE LIES WITH YOU. +***********************license end**************************************/ + +/** + * @file + * + * Interface to the SMI/MDIO hardware, including support for both IEEE 802.3 + * clause 22 and clause 45 operations. + * + * <hr>$Revision: 51350 $<hr> + * + * @addtogroup hal + * @{ + */ + +/** + * PHY register 0 from the 802.3 spec + */ +#define BDK_MDIO_PHY_REG_CONTROL 0 +typedef union +{ + uint16_t u16; + struct + { +#if __BYTE_ORDER == __BIG_ENDIAN + uint16_t reset : 1; + uint16_t loopback : 1; + uint16_t speed_lsb : 1; + uint16_t autoneg_enable : 1; + uint16_t power_down : 1; + uint16_t isolate : 1; + uint16_t restart_autoneg : 1; + uint16_t duplex : 1; + uint16_t collision_test : 1; + uint16_t speed_msb : 1; + uint16_t unidirectional_enable : 1; + uint16_t reserved_0_4 : 5; +#else + uint16_t reserved_0_4 : 5; + uint16_t unidirectional_enable : 1; + uint16_t speed_msb : 1; + uint16_t collision_test : 1; + uint16_t duplex : 1; + uint16_t restart_autoneg : 1; + uint16_t isolate : 1; + uint16_t power_down : 1; + uint16_t autoneg_enable : 1; + uint16_t speed_lsb : 1; + uint16_t loopback : 1; + uint16_t reset : 1; +#endif + } s; +} bdk_mdio_phy_reg_control_t; + +/** + * PHY register 1 from the 802.3 spec + */ +#define BDK_MDIO_PHY_REG_STATUS 1 +typedef union +{ + uint16_t u16; + struct + { +#if __BYTE_ORDER == __BIG_ENDIAN + uint16_t capable_100base_t4 : 1; + uint16_t capable_100base_x_full : 1; + uint16_t capable_100base_x_half : 1; + uint16_t capable_10_full : 1; + uint16_t capable_10_half : 1; + uint16_t capable_100base_t2_full : 1; + uint16_t capable_100base_t2_half : 1; + uint16_t capable_extended_status : 1; + uint16_t capable_unidirectional : 1; + uint16_t capable_mf_preamble_suppression : 1; + uint16_t autoneg_complete : 1; + uint16_t remote_fault : 1; + uint16_t capable_autoneg : 1; + uint16_t link_status : 1; + uint16_t jabber_detect : 1; + uint16_t capable_extended_registers : 1; +#else + uint16_t capable_extended_registers : 1; + uint16_t jabber_detect : 1; + uint16_t link_status : 1; + uint16_t capable_autoneg : 1; + uint16_t remote_fault : 1; + uint16_t autoneg_complete : 1; + uint16_t capable_mf_preamble_suppression : 1; + uint16_t capable_unidirectional : 1; + uint16_t capable_extended_status : 1; + uint16_t capable_100base_t2_half : 1; + uint16_t capable_100base_t2_full : 1; + uint16_t capable_10_half : 1; + uint16_t capable_10_full : 1; + uint16_t capable_100base_x_half : 1; + uint16_t capable_100base_x_full : 1; + uint16_t capable_100base_t4 : 1; +#endif + } s; +} bdk_mdio_phy_reg_status_t; + +/** + * PHY register 2 from the 802.3 spec + */ +#define BDK_MDIO_PHY_REG_ID1 2 +typedef union +{ + uint16_t u16; + struct + { + uint16_t oui_bits_3_18; + } s; +} bdk_mdio_phy_reg_id1_t; + +/** + * PHY register 3 from the 802.3 spec + */ +#define BDK_MDIO_PHY_REG_ID2 3 +typedef union +{ + uint16_t u16; + struct + { +#if __BYTE_ORDER == __BIG_ENDIAN + uint16_t oui_bits_19_24 : 6; + uint16_t model : 6; + uint16_t revision : 4; +#else + uint16_t revision : 4; + uint16_t model : 6; + uint16_t oui_bits_19_24 : 6; +#endif + } s; +} bdk_mdio_phy_reg_id2_t; + +/** + * PHY register 4 from the 802.3 spec + */ +#define BDK_MDIO_PHY_REG_AUTONEG_ADVER 4 +typedef union +{ + uint16_t u16; + struct + { +#if __BYTE_ORDER == __BIG_ENDIAN + uint16_t next_page : 1; + uint16_t reserved_14 : 1; + uint16_t remote_fault : 1; + uint16_t reserved_12 : 1; + uint16_t asymmetric_pause : 1; + uint16_t pause : 1; + uint16_t advert_100base_t4 : 1; + uint16_t advert_100base_tx_full : 1; + uint16_t advert_100base_tx_half : 1; + uint16_t advert_10base_tx_full : 1; + uint16_t advert_10base_tx_half : 1; + uint16_t selector : 5; +#else + uint16_t selector : 5; + uint16_t advert_10base_tx_half : 1; + uint16_t advert_10base_tx_full : 1; + uint16_t advert_100base_tx_half : 1; + uint16_t advert_100base_tx_full : 1; + uint16_t advert_100base_t4 : 1; + uint16_t pause : 1; + uint16_t asymmetric_pause : 1; + uint16_t reserved_12 : 1; + uint16_t remote_fault : 1; + uint16_t reserved_14 : 1; + uint16_t next_page : 1; +#endif + } s; +} bdk_mdio_phy_reg_autoneg_adver_t; + +/** + * PHY register 5 from the 802.3 spec + */ +#define BDK_MDIO_PHY_REG_LINK_PARTNER_ABILITY 5 +typedef union +{ + uint16_t u16; + struct + { +#if __BYTE_ORDER == __BIG_ENDIAN + uint16_t next_page : 1; + uint16_t ack : 1; + uint16_t remote_fault : 1; + uint16_t reserved_12 : 1; + uint16_t asymmetric_pause : 1; + uint16_t pause : 1; + uint16_t advert_100base_t4 : 1; + uint16_t advert_100base_tx_full : 1; + uint16_t advert_100base_tx_half : 1; + uint16_t advert_10base_tx_full : 1; + uint16_t advert_10base_tx_half : 1; + uint16_t selector : 5; +#else + uint16_t selector : 5; + uint16_t advert_10base_tx_half : 1; + uint16_t advert_10base_tx_full : 1; + uint16_t advert_100base_tx_half : 1; + uint16_t advert_100base_tx_full : 1; + uint16_t advert_100base_t4 : 1; + uint16_t pause : 1; + uint16_t asymmetric_pause : 1; + uint16_t reserved_12 : 1; + uint16_t remote_fault : 1; + uint16_t ack : 1; + uint16_t next_page : 1; +#endif + } s; +} bdk_mdio_phy_reg_link_partner_ability_t; + +/** + * PHY register 6 from the 802.3 spec + */ +#define BDK_MDIO_PHY_REG_AUTONEG_EXPANSION 6 +typedef union +{ + uint16_t u16; + struct + { +#if __BYTE_ORDER == __BIG_ENDIAN + uint16_t reserved_5_15 : 11; + uint16_t parallel_detection_fault : 1; + uint16_t link_partner_next_page_capable : 1; + uint16_t local_next_page_capable : 1; + uint16_t page_received : 1; + uint16_t link_partner_autoneg_capable : 1; +#else + uint16_t link_partner_autoneg_capable : 1; + uint16_t page_received : 1; + uint16_t local_next_page_capable : 1; + uint16_t link_partner_next_page_capable : 1; + uint16_t parallel_detection_fault : 1; + uint16_t reserved_5_15 : 11; +#endif + } s; +} bdk_mdio_phy_reg_autoneg_expansion_t; + +/** + * PHY register 9 from the 802.3 spec + */ +#define BDK_MDIO_PHY_REG_CONTROL_1000 9 +typedef union +{ + uint16_t u16; + struct + { +#if __BYTE_ORDER == __BIG_ENDIAN + uint16_t test_mode : 3; + uint16_t manual_master_slave : 1; + uint16_t master : 1; + uint16_t port_type : 1; + uint16_t advert_1000base_t_full : 1; + uint16_t advert_1000base_t_half : 1; + uint16_t reserved_0_7 : 8; +#else + uint16_t reserved_0_7 : 8; + uint16_t advert_1000base_t_half : 1; + uint16_t advert_1000base_t_full : 1; + uint16_t port_type : 1; + uint16_t master : 1; + uint16_t manual_master_slave : 1; + uint16_t test_mode : 3; +#endif + } s; +} bdk_mdio_phy_reg_control_1000_t; + +/** + * PHY register 10 from the 802.3 spec + */ +#define BDK_MDIO_PHY_REG_STATUS_1000 10 +typedef union +{ + uint16_t u16; + struct + { +#if __BYTE_ORDER == __BIG_ENDIAN + uint16_t master_slave_fault : 1; + uint16_t is_master : 1; + uint16_t local_receiver_ok : 1; + uint16_t remote_receiver_ok : 1; + uint16_t remote_capable_1000base_t_full : 1; + uint16_t remote_capable_1000base_t_half : 1; + uint16_t reserved_8_9 : 2; + uint16_t idle_error_count : 8; +#else + uint16_t idle_error_count : 8; + uint16_t reserved_8_9 : 2; + uint16_t remote_capable_1000base_t_half : 1; + uint16_t remote_capable_1000base_t_full : 1; + uint16_t remote_receiver_ok : 1; + uint16_t local_receiver_ok : 1; + uint16_t is_master : 1; + uint16_t master_slave_fault : 1; +#endif + } s; +} bdk_mdio_phy_reg_status_1000_t; + +/** + * PHY register 15 from the 802.3 spec + */ +#define BDK_MDIO_PHY_REG_EXTENDED_STATUS 15 +typedef union +{ + uint16_t u16; + struct + { +#if __BYTE_ORDER == __BIG_ENDIAN + uint16_t capable_1000base_x_full : 1; + uint16_t capable_1000base_x_half : 1; + uint16_t capable_1000base_t_full : 1; + uint16_t capable_1000base_t_half : 1; + uint16_t reserved_0_11 : 12; +#else + uint16_t reserved_0_11 : 12; + uint16_t capable_1000base_t_half : 1; + uint16_t capable_1000base_t_full : 1; + uint16_t capable_1000base_x_half : 1; + uint16_t capable_1000base_x_full : 1; +#endif + } s; +} bdk_mdio_phy_reg_extended_status_t; + + +/** + * PHY register 13 from the 802.3 spec + */ +#define BDK_MDIO_PHY_REG_MMD_CONTROL 13 +typedef union +{ + uint16_t u16; + struct + { +#if __BYTE_ORDER == __BIG_ENDIAN + uint16_t function : 2; + uint16_t reserved_5_13 : 9; + uint16_t devad : 5; +#else + uint16_t devad : 5; + uint16_t reserved_5_13 : 9; + uint16_t function : 2; +#endif + } s; +} bdk_mdio_phy_reg_mmd_control_t; + +/** + * PHY register 14 from the 802.3 spec + */ +#define BDK_MDIO_PHY_REG_MMD_ADDRESS_DATA 14 +typedef union +{ + uint16_t u16; + struct + { + uint16_t address_data : 16; + } s; +} bdk_mdio_phy_reg_mmd_address_data_t; + +/* MMD identifiers, mostly for accessing devices within XENPAK modules. */ +#define BDK_MMD_DEVICE_PMA_PMD 1 +#define BDK_MMD_DEVICE_WIS 2 +#define BDK_MMD_DEVICE_PCS 3 +#define BDK_MMD_DEVICE_PHY_XS 4 +#define BDK_MMD_DEVICE_DTS_XS 5 +#define BDK_MMD_DEVICE_TC 6 +#define BDK_MMD_DEVICE_CL22_EXT 29 +#define BDK_MMD_DEVICE_VENDOR_1 30 +#define BDK_MMD_DEVICE_VENDOR_2 31 + +/** + * Perform an MII read. This function is used to read PHY + * registers controlling auto negotiation. + * + * @param node Node to use in a Numa setup. Can be an exact ID or a special + * value. + * @param bus_id MDIO bus number. Zero on most chips, but some chips (ex CN56XX) + * support multiple busses. + * @param phy_id The MII phy id + * @param location Register location to read + * + * @return Result from the read or -1 on failure + */ +extern int bdk_mdio_read(bdk_node_t node, int bus_id, int phy_id, int location); + +/** + * Perform an MII write. This function is used to write PHY + * registers controlling auto negotiation. + * + * @param node Node to use in a Numa setup. Can be an exact ID or a special + * value. + * @param bus_id MDIO bus number. Zero on most chips, but some chips (ex CN56XX) + * support multiple busses. + * @param phy_id The MII phy id + * @param location Register location to write + * @param val Value to write + * + * @return -1 on error + * 0 on success + */ +extern int bdk_mdio_write(bdk_node_t node, int bus_id, int phy_id, int location, int val); + +/** + * Perform an IEEE 802.3 clause 45 MII read. This function is used to read PHY + * registers controlling auto negotiation. + * + * @param node Node to use in a Numa setup. Can be an exact ID or a special + * value. + * @param bus_id MDIO bus number. Zero on most chips, but some chips (ex CN56XX) + * support multiple busses. + * @param phy_id The MII phy id + * @param device MDIO Manageable Device (MMD) id + * @param location Register location to read + * + * @return Result from the read or -1 on failure + */ + +extern int bdk_mdio_45_read(bdk_node_t node, int bus_id, int phy_id, int device, int location); + +/** + * Perform an IEEE 802.3 clause 45 MII write. This function is used to write PHY + * registers controlling auto negotiation. + * + * @param node Node to use in a Numa setup. Can be an exact ID or a special + * value. + * @param bus_id MDIO bus number. Zero on most chips, but some chips (ex CN56XX) + * support multiple busses. + * @param phy_id The MII phy id + * @param device MDIO Manageable Device (MMD) id + * @param location Register location to write + * @param val Value to write + * + * @return -1 on error + * 0 on success + */ +extern int bdk_mdio_45_write(bdk_node_t node, int bus_id, int phy_id, int device, int location, + int val); + +/** @} */ |