0001 * APM X-Gene 15Gbps Multi-purpose PHY nodes
0002
0003 PHY nodes are defined to describe on-chip 15Gbps Multi-purpose PHY. Each
0004 PHY (pair of lanes) has its own node.
0005
0006 Required properties:
0007 - compatible : Shall be "apm,xgene-phy".
0008 - reg : PHY memory resource is the SDS PHY access resource.
0009 - #phy-cells : Shall be 1 as it expects one argument for setting
0010 the mode of the PHY. Possible values are 0 (SATA),
0011 1 (SGMII), 2 (PCIe), 3 (USB), and 4 (XFI).
0012
0013 Optional properties:
0014 - status : Shall be "ok" if enabled or "disabled" if disabled.
0015 Default is "ok".
0016 - clocks : Reference to the clock entry.
0017 - apm,tx-eye-tuning : Manual control to fine tune the capture of the serial
0018 bit lines from the automatic calibrated position.
0019 Two set of 3-tuple setting for each (up to 3)
0020 supported link speed on the host. Range from 0 to
0021 127 in unit of one bit period. Default is 10.
0022 - apm,tx-eye-direction : Eye tuning manual control direction. 0 means sample
0023 data earlier than the nominal sampling point. 1 means
0024 sample data later than the nominal sampling point.
0025 Two set of 3-tuple setting for each (up to 3)
0026 supported link speed on the host. Default is 0.
0027 - apm,tx-boost-gain : Frequency boost AC (LSB 3-bit) and DC (2-bit)
0028 gain control. Two set of 3-tuple setting for each
0029 (up to 3) supported link speed on the host. Range is
0030 between 0 to 31 in unit of dB. Default is 3.
0031 - apm,tx-amplitude : Amplitude control. Two set of 3-tuple setting for
0032 each (up to 3) supported link speed on the host.
0033 Range is between 0 to 199500 in unit of uV.
0034 Default is 199500 uV.
0035 - apm,tx-pre-cursor1 : 1st pre-cursor emphasis taps control. Two set of
0036 3-tuple setting for each (up to 3) supported link
0037 speed on the host. Range is 0 to 273000 in unit of
0038 uV. Default is 0.
0039 - apm,tx-pre-cursor2 : 2st pre-cursor emphasis taps control. Two set of
0040 3-tuple setting for each (up to 3) supported link
0041 speed on the host. Range is 0 to 127400 in unit uV.
0042 Default is 0x0.
0043 - apm,tx-post-cursor : Post-cursor emphasis taps control. Two set of
0044 3-tuple setting for Gen1, Gen2, and Gen3. Range is
0045 between 0 to 0x1f in unit of 18.2mV. Default is 0xf.
0046 - apm,tx-speed : Tx operating speed. One set of 3-tuple for each
0047 supported link speed on the host.
0048 0 = 1-2Gbps
0049 1 = 2-4Gbps (1st tuple default)
0050 2 = 4-8Gbps
0051 3 = 8-15Gbps (2nd tuple default)
0052 4 = 2.5-4Gbps
0053 5 = 4-5Gbps
0054 6 = 5-6Gbps
0055 7 = 6-16Gbps (3rd tuple default)
0056
0057 NOTE: PHY override parameters are board specific setting.
0058
0059 Example:
0060 phy1: phy@1f21a000 {
0061 compatible = "apm,xgene-phy";
0062 reg = <0x0 0x1f21a000 0x0 0x100>;
0063 #phy-cells = <1>;
0064 };
0065
0066 phy2: phy@1f22a000 {
0067 compatible = "apm,xgene-phy";
0068 reg = <0x0 0x1f22a000 0x0 0x100>;
0069 #phy-cells = <1>;
0070 };
0071
0072 phy3: phy@1f23a000 {
0073 compatible = "apm,xgene-phy";
0074 reg = <0x0 0x1f23a000 0x0 0x100>;
0075 #phy-cells = <1>;
0076 };
