1 # SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
2 %YAML 1.2
3 ---
4 $id: http://devicetree.org/schemas/phy/brcm,sata-phy.yaml#
5 $schema: http://devicetree.org/meta-schemas/core.yaml#
6
7 title: Broadcom SATA3 PHY
8
9 maintainers:
10 - Florian Fainelli <f.fainelli@gmail.com>
11
12 properties:
13 $nodename:
14 pattern: "^sata[-|_]phy(@.*)?$"
15
16 compatible:
17 oneOf:
18 - items:
19 - enum:
20 - brcm,bcm7216-sata-phy
21 - brcm,bcm7425-sata-phy
22 - brcm,bcm7445-sata-phy
23 - brcm,bcm63138-sata-phy
24 - const: brcm,phy-sata3
25 - items:
26 - const: brcm,iproc-nsp-sata-phy
27 - items:
28 - const: brcm,iproc-ns2-sata-phy
29 - items:
30 - const: brcm,iproc-sr-sata-phy
31
32 reg:
33 minItems: 1
34 maxItems: 2
35
36 reg-names:
37 minItems: 1
38 items:
39 - const: phy
40 - const: phy-ctrl
41
42 "#address-cells":
43 const: 1
44
45 "#size-cells":
46 const: 0
47
48 patternProperties:
49 "^sata-phy@[0-9]+$":
50 type: object
51 description: |
52 Each port's PHY should be represented as a sub-node.
53
54 properties:
55 reg:
56 description: The SATA PHY port number
57 maxItems: 1
58
59 "#phy-cells":
60 const: 0
61
62 brcm,enable-ssc:
63 $ref: /schemas/types.yaml#/definitions/flag
64 description: |
65 Use spread spectrum clocking (SSC) on this port
66 This property is not applicable for "brcm,iproc-ns2-sata-phy",
67 "brcm,iproc-nsp-sata-phy" and "brcm,iproc-sr-sata-phy".
68
69 brcm,rxaeq-mode:
70 $ref: /schemas/types.yaml#/definitions/string
71 description:
72 String that indicates the desired RX equalizer mode.
73 enum:
74 - off
75 - auto
76 - manual
77
78 brcm,rxaeq-value:
79 $ref: /schemas/types.yaml#/definitions/uint32
80 description: |
81 When 'brcm,rxaeq-mode' is set to "manual", provides the RX
82 equalizer value that should be used.
83 minimum: 0
84 maximum: 63
85
86 brcm,tx-amplitude-millivolt:
87 description: |
88 Transmit amplitude voltage in millivolt.
89 $ref: /schemas/types.yaml#/definitions/uint32
90 enum: [400, 500, 600, 800]
91
92 required:
93 - reg
94 - "#phy-cells"
95
96 additionalProperties: false
97
98 if:
99 properties:
100 compatible:
101 const: brcm,iproc-ns2-sata-phy
102 then:
103 properties:
104 reg:
105 minItems: 2
106
107 reg-names:
108 minItems: 2
109 else:
110 properties:
111 reg:
112 maxItems: 1
113
114 reg-names:
115 maxItems: 1
116
117 required:
118 - compatible
119 - "#address-cells"
120 - "#size-cells"
121 - reg
122 - reg-names
123
124 additionalProperties: false
125
126 examples:
127 - |
128 sata_phy@f0458100 {
129 compatible = "brcm,bcm7445-sata-phy", "brcm,phy-sata3";
130 reg = <0xf0458100 0x1e00>;
131 reg-names = "phy";
132 #address-cells = <1>;
133 #size-cells = <0>;
134
135 sata-phy@0 {
136 reg = <0>;
137 #phy-cells = <0>;
138 };
139
140 sata-phy@1 {
141 reg = <1>;
142 #phy-cells = <0>;
143 };
144 };
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.