Linux kernel mirror (for testing)
git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel
os
linux
dt-bindings: phy: rk3228-hdmi-phy: convert to yaml
Convert the binding to yaml and rename it according to its first
compatible instead of the unspecific rockchip-inno-hdmi naming.
Signed-off-by: Heiko Stuebner <heiko@sntech.de>
Reviewed-by: Rob Herring (Arm) <robh@kernel.org>
Link: https://lore.kernel.org/r/20241007162732.2450168-1-heiko@sntech.de
Signed-off-by: Vinod Koul <vkoul@kernel.org>
authored by
Heiko Stuebner
and committed by
Vinod Koul
de309069
54234e3a
+97
-43
-43
Documentation/devicetree/bindings/phy/phy-rockchip-inno-hdmi.txt
-43
Documentation/devicetree/bindings/phy/phy-rockchip-inno-hdmi.txt
···
1
-
ROCKCHIP HDMI PHY WITH INNO IP BLOCK
2
-
3
-
Required properties:
4
-
- compatible : should be one of the listed compatibles:
5
-
* "rockchip,rk3228-hdmi-phy",
6
-
* "rockchip,rk3328-hdmi-phy";
7
-
- reg : Address and length of the hdmi phy control register set
8
-
- clocks : phandle + clock specifier for the phy clocks
9
-
- clock-names : string, clock name, must contain "sysclk" for system
10
-
control and register configuration, "refoclk" for crystal-
11
-
oscillator reference PLL clock input and "refpclk" for pclk-
12
-
based refeference PLL clock input.
13
-
- #clock-cells: should be 0.
14
-
- clock-output-names : shall be the name for the output clock.
15
-
- interrupts : phandle + interrupt specified for the hdmiphy interrupt
16
-
- #phy-cells : must be 0. See ./phy-bindings.txt for details.
17
-
18
-
Optional properties for rk3328-hdmi-phy:
19
-
- nvmem-cells = phandle + nvmem specifier for the cpu-version efuse
20
-
- nvmem-cell-names : "cpu-version" to read the chip version, required
21
-
for adjustment to some frequency settings
22
-
23
-
Example:
24
-
hdmi_phy: hdmi-phy@12030000 {
25
-
compatible = "rockchip,rk3228-hdmi-phy";
26
-
reg = <0x12030000 0x10000>;
27
-
#phy-cells = <0>;
28
-
clocks = <&cru PCLK_HDMI_PHY>, <&xin24m>, <&cru DCLK_HDMIPHY>;
29
-
clock-names = "sysclk", "refoclk", "refpclk";
30
-
#clock-cells = <0>;
31
-
clock-output-names = "hdmi_phy";
32
-
status = "disabled";
33
-
};
34
-
35
-
Then the PHY can be used in other nodes such as:
36
-
37
-
hdmi: hdmi@200a0000 {
38
-
compatible = "rockchip,rk3228-dw-hdmi";
39
-
...
40
-
phys = <&hdmi_phy>;
41
-
phy-names = "hdmi";
42
-
...
43
-
};
+97
Documentation/devicetree/bindings/phy/rockchip,rk3228-hdmi-phy.yaml
+97
Documentation/devicetree/bindings/phy/rockchip,rk3228-hdmi-phy.yaml
···
1
+
# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2
+
%YAML 1.2
3
+
---
4
+
$id: http://devicetree.org/schemas/phy/rockchip,rk3228-hdmi-phy.yaml#
5
+
$schema: http://devicetree.org/meta-schemas/core.yaml#
6
+
7
+
title: Rockchip HDMI PHY with Innosilicon IP block
8
+
9
+
maintainers:
10
+
- Heiko Stuebner <heiko@sntech.de>
11
+
12
+
properties:
13
+
compatible:
14
+
enum:
15
+
- rockchip,rk3228-hdmi-phy
16
+
- rockchip,rk3328-hdmi-phy
17
+
18
+
reg:
19
+
maxItems: 1
20
+
21
+
clocks:
22
+
maxItems: 3
23
+
24
+
clock-names:
25
+
items:
26
+
- const: sysclk
27
+
- const: refoclk
28
+
- const: refpclk
29
+
30
+
clock-output-names:
31
+
description:
32
+
The hdmiphy output clock name, that gets fed back to the CRU.
33
+
34
+
"#clock-cells":
35
+
const: 0
36
+
37
+
interrupts:
38
+
maxItems: 1
39
+
40
+
nvmem-cells:
41
+
maxItems: 1
42
+
description: A phandle + nvmem specifier for the cpu-version efuse
43
+
for adjustment to some frequency settings, depending on cpu-version
44
+
45
+
nvmem-cell-names:
46
+
items:
47
+
- const: cpu-version
48
+
49
+
'#phy-cells':
50
+
const: 0
51
+
52
+
required:
53
+
- compatible
54
+
- reg
55
+
- clocks
56
+
- clock-names
57
+
- clock-output-names
58
+
- '#clock-cells'
59
+
- '#phy-cells'
60
+
61
+
allOf:
62
+
- if:
63
+
properties:
64
+
compatible:
65
+
contains:
66
+
const: rockchip,rk3228-hdmi-phy
67
+
68
+
then:
69
+
properties:
70
+
interrupts: false
71
+
72
+
- if:
73
+
properties:
74
+
compatible:
75
+
contains:
76
+
const: rockchip,rk3328-hdmi-phy
77
+
78
+
then:
79
+
required:
80
+
- interrupts
81
+
82
+
additionalProperties: false
83
+
84
+
examples:
85
+
- |
86
+
87
+
#include <dt-bindings/clock/rk3228-cru.h>
88
+
hdmi_phy: phy@12030000 {
89
+
compatible = "rockchip,rk3228-hdmi-phy";
90
+
reg = <0x12030000 0x10000>;
91
+
#phy-cells = <0>;
92
+
clocks = <&cru PCLK_HDMI_PHY>, <&xin24m>, <&cru DCLK_HDMI_PHY>;
93
+
clock-names = "sysclk", "refoclk", "refpclk";
94
+
#clock-cells = <0>;
95
+
96
+
clock-output-names = "hdmi_phy";
97
+
};