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)
11   hardware included with the Cadence MHDP DisplayPort controller. Torrent
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>;