blob: d3cd7997879f7f2d0d66bea07486b0a921bef334 [file] [log] [blame]
Tom Rini53633a82024-02-29 12:33:36 -05001# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2%YAML 1.2
3---
4$id: http://devicetree.org/schemas/phy/phy-rockchip-naneng-combphy.yaml#
5$schema: http://devicetree.org/meta-schemas/core.yaml#
6
7title: Rockchip SoC Naneng Combo Phy
8
9maintainers:
10 - Heiko Stuebner <heiko@sntech.de>
11
12properties:
13 compatible:
14 enum:
15 - rockchip,rk3568-naneng-combphy
16 - rockchip,rk3588-naneng-combphy
17
18 reg:
19 maxItems: 1
20
21 clocks:
22 items:
23 - description: reference clock
24 - description: apb clock
25 - description: pipe clock
26
27 clock-names:
28 items:
29 - const: ref
30 - const: apb
31 - const: pipe
32
33 resets:
34 minItems: 1
35 maxItems: 2
36
37 reset-names:
38 minItems: 1
39 items:
40 - const: phy
41 - const: apb
42
43 rockchip,enable-ssc:
44 type: boolean
45 description:
46 The option SSC can be enabled for U3, SATA and PCIE.
47 Most commercially available platforms use SSC to reduce EMI.
48
49 rockchip,ext-refclk:
50 type: boolean
51 description:
52 Many PCIe connections, especially backplane connections,
53 require a synchronous reference clock between the two link partners.
54 To achieve this a common clock source, referred to as REFCLK in
55 the PCI Express Card Electromechanical Specification,
56 should be used by both ends of the PCIe link.
57 In PCIe mode one can choose to use an internal or an external reference
58 clock.
59 By default the internal clock is selected. The PCIe PHY provides a 100MHz
60 differential clock output(optional with SSC) for system applications.
61 When selecting this option an externally 100MHz differential
62 reference clock needs to be provided to the PCIe PHY.
63
64 rockchip,pipe-grf:
65 $ref: /schemas/types.yaml#/definitions/phandle
66 description:
67 Some additional phy settings are accessed through GRF regs.
68
69 rockchip,pipe-phy-grf:
70 $ref: /schemas/types.yaml#/definitions/phandle
71 description:
72 Some additional pipe settings are accessed through GRF regs.
73
74 "#phy-cells":
75 const: 1
76
77required:
78 - compatible
79 - reg
80 - clocks
81 - clock-names
82 - resets
83 - rockchip,pipe-grf
84 - rockchip,pipe-phy-grf
85 - "#phy-cells"
86
87allOf:
88 - if:
89 properties:
90 compatible:
91 contains:
92 const: rockchip,rk3568-naneng-combphy
93 then:
94 properties:
95 resets:
96 maxItems: 1
97 reset-names:
98 maxItems: 1
99 - if:
100 properties:
101 compatible:
102 contains:
103 const: rockchip,rk3588-naneng-combphy
104 then:
105 properties:
106 resets:
107 minItems: 2
108 reset-names:
109 minItems: 2
110 required:
111 - reset-names
112
113additionalProperties: false
114
115examples:
116 - |
117 #include <dt-bindings/clock/rk3568-cru.h>
118
119 pipegrf: syscon@fdc50000 {
120 compatible = "rockchip,rk3568-pipe-grf", "syscon";
121 reg = <0xfdc50000 0x1000>;
122 };
123
124 pipe_phy_grf0: syscon@fdc70000 {
125 compatible = "rockchip,rk3568-pipe-phy-grf", "syscon";
126 reg = <0xfdc70000 0x1000>;
127 };
128
129 combphy0: phy@fe820000 {
130 compatible = "rockchip,rk3568-naneng-combphy";
131 reg = <0xfe820000 0x100>;
132 clocks = <&pmucru CLK_PCIEPHY0_REF>,
133 <&cru PCLK_PIPEPHY0>,
134 <&cru PCLK_PIPE>;
135 clock-names = "ref", "apb", "pipe";
136 assigned-clocks = <&pmucru CLK_PCIEPHY0_REF>;
137 assigned-clock-rates = <100000000>;
138 resets = <&cru SRST_PIPEPHY0>;
139 rockchip,pipe-grf = <&pipegrf>;
140 rockchip,pipe-phy-grf = <&pipe_phy_grf0>;
141 #phy-cells = <1>;
142 };