^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1) * APM X-Gene 15Gbps Multi-purpose PHY nodes
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 3) PHY nodes are defined to describe on-chip 15Gbps Multi-purpose PHY. Each
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 4) PHY (pair of lanes) has its own node.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 5)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 6) Required properties:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 7) - compatible : Shall be "apm,xgene-phy".
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 8) - reg : PHY memory resource is the SDS PHY access resource.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 9) - #phy-cells : Shall be 1 as it expects one argument for setting
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 10) the mode of the PHY. Possible values are 0 (SATA),
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 11) 1 (SGMII), 2 (PCIe), 3 (USB), and 4 (XFI).
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 12)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 13) Optional properties:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 14) - status : Shall be "ok" if enabled or "disabled" if disabled.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 15) Default is "ok".
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 16) - clocks : Reference to the clock entry.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 17) - apm,tx-eye-tuning : Manual control to fine tune the capture of the serial
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 18) bit lines from the automatic calibrated position.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 19) Two set of 3-tuple setting for each (up to 3)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 20) supported link speed on the host. Range from 0 to
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 21) 127 in unit of one bit period. Default is 10.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 22) - apm,tx-eye-direction : Eye tuning manual control direction. 0 means sample
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 23) data earlier than the nominal sampling point. 1 means
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 24) sample data later than the nominal sampling point.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 25) Two set of 3-tuple setting for each (up to 3)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 26) supported link speed on the host. Default is 0.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 27) - apm,tx-boost-gain : Frequency boost AC (LSB 3-bit) and DC (2-bit)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 28) gain control. Two set of 3-tuple setting for each
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 29) (up to 3) supported link speed on the host. Range is
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 30) between 0 to 31 in unit of dB. Default is 3.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 31) - apm,tx-amplitude : Amplitude control. Two set of 3-tuple setting for
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 32) each (up to 3) supported link speed on the host.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 33) Range is between 0 to 199500 in unit of uV.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 34) Default is 199500 uV.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 35) - apm,tx-pre-cursor1 : 1st pre-cursor emphasis taps control. Two set of
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 36) 3-tuple setting for each (up to 3) supported link
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 37) speed on the host. Range is 0 to 273000 in unit of
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 38) uV. Default is 0.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 39) - apm,tx-pre-cursor2 : 2st pre-cursor emphasis taps control. Two set of
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 40) 3-tuple setting for each (up to 3) supported link
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 41) speed on the host. Range is 0 to 127400 in unit uV.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 42) Default is 0x0.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 43) - apm,tx-post-cursor : Post-cursor emphasis taps control. Two set of
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 44) 3-tuple setting for Gen1, Gen2, and Gen3. Range is
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 45) between 0 to 0x1f in unit of 18.2mV. Default is 0xf.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 46) - apm,tx-speed : Tx operating speed. One set of 3-tuple for each
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 47) supported link speed on the host.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 48) 0 = 1-2Gbps
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 49) 1 = 2-4Gbps (1st tuple default)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 50) 2 = 4-8Gbps
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 51) 3 = 8-15Gbps (2nd tuple default)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 52) 4 = 2.5-4Gbps
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 53) 5 = 4-5Gbps
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 54) 6 = 5-6Gbps
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 55) 7 = 6-16Gbps (3rd tuple default)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 56)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 57) NOTE: PHY override parameters are board specific setting.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 58)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 59) Example:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 60) phy1: phy@1f21a000 {
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 61) compatible = "apm,xgene-phy";
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 62) reg = <0x0 0x1f21a000 0x0 0x100>;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 63) #phy-cells = <1>;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 64) };
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 65)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 66) phy2: phy@1f22a000 {
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 67) compatible = "apm,xgene-phy";
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 68) reg = <0x0 0x1f22a000 0x0 0x100>;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 69) #phy-cells = <1>;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 70) };
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 71)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 72) phy3: phy@1f23a000 {
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 73) compatible = "apm,xgene-phy";
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 74) reg = <0x0 0x1f23a000 0x0 0x100>;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 75) #phy-cells = <1>;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 76) };