^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1) * Broadcom SATA3 PHY
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 3) Required properties:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 4) - compatible: should be one or more of
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 5) "brcm,bcm7216-sata-phy"
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 6) "brcm,bcm7425-sata-phy"
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 7) "brcm,bcm7445-sata-phy"
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 8) "brcm,iproc-ns2-sata-phy"
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 9) "brcm,iproc-nsp-sata-phy"
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 10) "brcm,phy-sata3"
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 11) "brcm,iproc-sr-sata-phy"
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 12) "brcm,bcm63138-sata-phy"
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 13) - address-cells: should be 1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 14) - size-cells: should be 0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 15) - reg: register ranges for the PHY PCB interface
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 16) - reg-names: should be "phy" and "phy-ctrl"
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 17) The "phy-ctrl" registers are only required for
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 18) "brcm,iproc-ns2-sata-phy" and "brcm,iproc-sr-sata-phy".
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 19)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 20) Sub-nodes:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 21) Each port's PHY should be represented as a sub-node.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 22)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 23) Sub-nodes required properties:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 24) - reg: the PHY number
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 25) - phy-cells: generic PHY binding; must be 0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 26)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 27) Sub-nodes optional properties:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 28) - brcm,enable-ssc: use spread spectrum clocking (SSC) on this port
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 29) This property is not applicable for "brcm,iproc-ns2-sata-phy",
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 30) "brcm,iproc-nsp-sata-phy" and "brcm,iproc-sr-sata-phy".
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 31)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 32) - brcm,rxaeq-mode: string that indicates the desired RX equalizer
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 33) mode, possible values are:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 34) "off" (equivalent to not specifying the property)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 35) "auto"
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 36) "manual" (brcm,rxaeq-value is used in that case)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 37)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 38) - brcm,rxaeq-value: when 'rxaeq-mode' is set to "manual", provides the RX
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 39) equalizer value that should be used. Allowed range is 0..63.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 40)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 41) Example
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 42) sata-phy@f0458100 {
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 43) compatible = "brcm,bcm7445-sata-phy", "brcm,phy-sata3";
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 44) reg = <0xf0458100 0x1e00>, <0xf045804c 0x10>;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 45) reg-names = "phy";
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 46) #address-cells = <1>;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 47) #size-cells = <0>;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 48)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 49) sata-phy@0 {
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 50) reg = <0>;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 51) #phy-cells = <0>;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 52) };
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 53)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 54) sata-phy@1 {
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 55) reg = <1>;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 56) #phy-cells = <0>;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 57) };
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 58) };