summaryrefslogtreecommitdiffstats
path: root/Documentation/devicetree/bindings/phy/eswin,eic7700-sata-phy.yaml
blob: fc7dbac77acf76501eed16c0f67b6b45eb326d5b (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
# SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause
%YAML 1.2
---
$id: http://devicetree.org/schemas/phy/eswin,eic7700-sata-phy.yaml#
$schema: http://devicetree.org/meta-schemas/core.yaml#

title: Eswin EIC7700 SoC SATA PHY

maintainers:
  - Yulin Lu <luyulin@eswincomputing.com>
  - Huan He <hehuan1@eswincomputing.com>

properties:
  compatible:
    const: eswin,eic7700-sata-phy

  reg:
    maxItems: 1

  clocks:
    maxItems: 1

  clock-names:
    const: phy

  resets:
    maxItems: 2

  reset-names:
    items:
      - const: port
      - const: phy

  eswin,tx-amplitude-tuning:
    description: This adjusts the transmitter amplitude signal, and its value
      is derived from eye diagram tuning. The three values correspond to Gen1,
      Gen2, and Gen3 parameters respectively.
    $ref: /schemas/types.yaml#/definitions/uint32-array
    items:
      - description: Gen1 parameter.
        minimum: 0
        maximum: 0x7f
      - description: Gen2 parameter.
        minimum: 0
        maximum: 0x7f
      - description: Gen3 parameter.
        minimum: 0
        maximum: 0x7f
    default: [0, 0, 0]

  eswin,tx-preemph-tuning:
    description: This adjusts the transmitter de-emphasis signal, and its value
      is derived from eye diagram tuning. The three values correspond to Gen1,
      Gen2, and Gen3 parameters respectively.
    $ref: /schemas/types.yaml#/definitions/uint32-array
    items:
      - description: Gen1 parameter.
        minimum: 0
        maximum: 0x3f
      - description: Gen2 parameter.
        minimum: 0
        maximum: 0x3f
      - description: Gen3 parameter.
        minimum: 0
        maximum: 0x3f
    default: [0, 0, 0]

  "#phy-cells":
    const: 0

required:
  - compatible
  - reg
  - clocks
  - clock-names
  - resets
  - reset-names
  - "#phy-cells"

additionalProperties: false

examples:
  - |
    sata-phy@50440300 {
        compatible = "eswin,eic7700-sata-phy";
        reg = <0x50440300 0x40>;
        clocks = <&hspcrg 17>;
        clock-names = "phy";
        resets = <&hspcrg 0>, <&hspcrg 1>;
        reset-names = "port", "phy";
        #phy-cells = <0>;
    };