xref: /linux/Documentation/devicetree/bindings/phy/eswin,eic7700-sata-phy.yaml (revision 0fc8f6200d2313278fbf4539bbab74677c685531)
1*820265f7SYulin Lu# SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause
2*820265f7SYulin Lu%YAML 1.2
3*820265f7SYulin Lu---
4*820265f7SYulin Lu$id: http://devicetree.org/schemas/phy/eswin,eic7700-sata-phy.yaml#
5*820265f7SYulin Lu$schema: http://devicetree.org/meta-schemas/core.yaml#
6*820265f7SYulin Lu
7*820265f7SYulin Lutitle: Eswin EIC7700 SoC SATA PHY
8*820265f7SYulin Lu
9*820265f7SYulin Lumaintainers:
10*820265f7SYulin Lu  - Yulin Lu <luyulin@eswincomputing.com>
11*820265f7SYulin Lu  - Huan He <hehuan1@eswincomputing.com>
12*820265f7SYulin Lu
13*820265f7SYulin Luproperties:
14*820265f7SYulin Lu  compatible:
15*820265f7SYulin Lu    const: eswin,eic7700-sata-phy
16*820265f7SYulin Lu
17*820265f7SYulin Lu  reg:
18*820265f7SYulin Lu    maxItems: 1
19*820265f7SYulin Lu
20*820265f7SYulin Lu  clocks:
21*820265f7SYulin Lu    maxItems: 1
22*820265f7SYulin Lu
23*820265f7SYulin Lu  clock-names:
24*820265f7SYulin Lu    const: phy
25*820265f7SYulin Lu
26*820265f7SYulin Lu  resets:
27*820265f7SYulin Lu    maxItems: 2
28*820265f7SYulin Lu
29*820265f7SYulin Lu  reset-names:
30*820265f7SYulin Lu    items:
31*820265f7SYulin Lu      - const: port
32*820265f7SYulin Lu      - const: phy
33*820265f7SYulin Lu
34*820265f7SYulin Lu  eswin,tx-amplitude-tuning:
35*820265f7SYulin Lu    description: This adjusts the transmitter amplitude signal, and its value
36*820265f7SYulin Lu      is derived from eye diagram tuning. The three values correspond to Gen1,
37*820265f7SYulin Lu      Gen2, and Gen3 parameters respectively.
38*820265f7SYulin Lu    $ref: /schemas/types.yaml#/definitions/uint32-array
39*820265f7SYulin Lu    items:
40*820265f7SYulin Lu      - description: Gen1 parameter.
41*820265f7SYulin Lu        minimum: 0
42*820265f7SYulin Lu        maximum: 0x7f
43*820265f7SYulin Lu      - description: Gen2 parameter.
44*820265f7SYulin Lu        minimum: 0
45*820265f7SYulin Lu        maximum: 0x7f
46*820265f7SYulin Lu      - description: Gen3 parameter.
47*820265f7SYulin Lu        minimum: 0
48*820265f7SYulin Lu        maximum: 0x7f
49*820265f7SYulin Lu    default: [0, 0, 0]
50*820265f7SYulin Lu
51*820265f7SYulin Lu  eswin,tx-preemph-tuning:
52*820265f7SYulin Lu    description: This adjusts the transmitter de-emphasis signal, and its value
53*820265f7SYulin Lu      is derived from eye diagram tuning. The three values correspond to Gen1,
54*820265f7SYulin Lu      Gen2, and Gen3 parameters respectively.
55*820265f7SYulin Lu    $ref: /schemas/types.yaml#/definitions/uint32-array
56*820265f7SYulin Lu    items:
57*820265f7SYulin Lu      - description: Gen1 parameter.
58*820265f7SYulin Lu        minimum: 0
59*820265f7SYulin Lu        maximum: 0x3f
60*820265f7SYulin Lu      - description: Gen2 parameter.
61*820265f7SYulin Lu        minimum: 0
62*820265f7SYulin Lu        maximum: 0x3f
63*820265f7SYulin Lu      - description: Gen3 parameter.
64*820265f7SYulin Lu        minimum: 0
65*820265f7SYulin Lu        maximum: 0x3f
66*820265f7SYulin Lu    default: [0, 0, 0]
67*820265f7SYulin Lu
68*820265f7SYulin Lu  "#phy-cells":
69*820265f7SYulin Lu    const: 0
70*820265f7SYulin Lu
71*820265f7SYulin Lurequired:
72*820265f7SYulin Lu  - compatible
73*820265f7SYulin Lu  - reg
74*820265f7SYulin Lu  - clocks
75*820265f7SYulin Lu  - clock-names
76*820265f7SYulin Lu  - resets
77*820265f7SYulin Lu  - reset-names
78*820265f7SYulin Lu  - "#phy-cells"
79*820265f7SYulin Lu
80*820265f7SYulin LuadditionalProperties: false
81*820265f7SYulin Lu
82*820265f7SYulin Luexamples:
83*820265f7SYulin Lu  - |
84*820265f7SYulin Lu    sata-phy@50440300 {
85*820265f7SYulin Lu        compatible = "eswin,eic7700-sata-phy";
86*820265f7SYulin Lu        reg = <0x50440300 0x40>;
87*820265f7SYulin Lu        clocks = <&hspcrg 17>;
88*820265f7SYulin Lu        clock-names = "phy";
89*820265f7SYulin Lu        resets = <&hspcrg 0>, <&hspcrg 1>;
90*820265f7SYulin Lu        reset-names = "port", "phy";
91*820265f7SYulin Lu        #phy-cells = <0>;
92*820265f7SYulin Lu    };
93