bindings/phy/phy-cadence-torrent.yaml

1 # SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
3 ---
4 $id: http://devicetree.org/schemas/phy/phy-cadence-torrent.yaml#
5 $schema: http://devicetree.org/meta-schemas/core.yaml#
7 title: Cadence Torrent SD0801 PHY
10   This binding describes the Cadence SD0801 PHY (also known as Torrent PHY)
12   PHY also supports multilink multiprotocol combinations including protocols
16   - Swapnil Jakhade <sjakhade@cadence.com>
17   - Yuti Amonkar <yamonkar@cadence.com>
22       - cdns,torrent-phy
23       - ti,j721e-serdes-10g
25   '#address-cells':
28   '#size-cells':
31   '#clock-cells':
38       PHY reference clock for 1 item. Must contain an entry in clock-names.
41   clock-names:
44       - const: refclk
45       - const: phy_en_refclk
50       - description: Offset of the Torrent PHY configuration registers.
51       - description: Offset of the DPTX PHY configuration registers.
53   reg-names:
56       - const: torrent_phy
57       - const: dptx_phy
62       - description: Torrent PHY reset.
63       - description: Torrent APB reset. This is optional.
65   reset-names:
68       - const: torrent_reset
69       - const: torrent_apb
72   '^phy@[0-3]$':
75       Each group of PHY lanes with a single master lane should be represented as a sub-node.
89       "#phy-cells":
92       cdns,phy-type:
94           Specifies the type of PHY for which the group of PHY lanes is used.
95           Refer include/dt-bindings/phy/phy.h. Constants from the header should be used.
100       cdns,num-lanes:
107       cdns,ssc-mode:
111           Refer include/dt-bindings/phy/phy-cadence.h for the constants to be used.
116       cdns,max-bit-rate:
124       - reg
125       - resets
126       - "#phy-cells"
127       - cdns,phy-type
128       - cdns,num-lanes
133   - compatible
134   - "#address-cells"
135   - "#size-cells"
136   - clocks
137   - clock-names
138   - reg
139   - reg-names
140   - resets
141   - reset-names
146   - |
147     #include <dt-bindings/phy/phy.h>
150         #address-cells = <2>;
151         #size-cells = <2>;
153         torrent-phy@f0fb500000 {
154             compatible = "cdns,torrent-phy";
157             reg-names = "torrent_phy", "dptx_phy";
159             reset-names = "torrent_reset";
161             clock-names = "refclk";
162             #address-cells = <1>;
163             #size-cells = <0>;
164             phy@0 {
168                 #phy-cells = <0>;
169                 cdns,phy-type = <PHY_TYPE_DP>;
170                 cdns,num-lanes = <4>;
171                 cdns,max-bit-rate = <8100>;
175   - |
176     #include <dt-bindings/phy/phy.h>
177     #include <dt-bindings/phy/phy-cadence.h>
180         #address-cells = <2>;
181         #size-cells = <2>;
183         torrent-phy@f0fb500000 {
184             compatible = "cdns,torrent-phy";
186             reg-names = "torrent_phy";
188             reset-names = "torrent_reset", "torrent_apb";
190             clock-names = "refclk";
191             #address-cells = <1>;
192             #size-cells = <0>;
193             phy@0 {
196                 #phy-cells = <0>;
197                 cdns,phy-type = <PHY_TYPE_PCIE>;
198                 cdns,num-lanes = <2>;
199                 cdns,ssc-mode = <CDNS_SERDES_NO_SSC>;
202             phy@2 {
205                 #phy-cells = <0>;
206                 cdns,phy-type = <PHY_TYPE_SGMII>;
207                 cdns,num-lanes = <1>;
208                 cdns,ssc-mode = <CDNS_SERDES_NO_SSC>;