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