Linux kernel mirror (for testing)
git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel
os
linux
dt-bindings: clock: samsung: convert S5Pv210 to dtschema
Convert Samsung S5Pv210 SoC clock controller bindings to DT schema
format.
Signed-off-by: Krzysztof Kozlowski <krzysztof.kozlowski@canonical.com>
Reviewed-by: Stephen Boyd <sboyd@kernel.org>
Signed-off-by: Rob Herring <robh@kernel.org>
Link: https://lore.kernel.org/r/20220102115356.75796-8-krzysztof.kozlowski@canonical.com
authored by
Krzysztof Kozlowski
and committed by
Rob Herring
653c3d33
cc190b1f
+79
-78
-77
Documentation/devicetree/bindings/clock/samsung,s5pv210-clock.txt
-77
Documentation/devicetree/bindings/clock/samsung,s5pv210-clock.txt
···
1
-
* Samsung S5P6442/S5PC110/S5PV210 Clock Controller
2
-
3
-
Samsung S5P6442, S5PC110 and S5PV210 SoCs contain integrated clock
4
-
controller, which generates and supplies clock to various controllers
5
-
within the SoC.
6
-
7
-
Required Properties:
8
-
9
-
- compatible: should be one of following:
10
-
- "samsung,s5pv210-clock" : for clock controller of Samsung
11
-
S5PC110/S5PV210 SoCs,
12
-
- "samsung,s5p6442-clock" : for clock controller of Samsung
13
-
S5P6442 SoC.
14
-
15
-
- reg: physical base address of the controller and length of memory mapped
16
-
region.
17
-
18
-
- #clock-cells: should be 1.
19
-
20
-
All available clocks are defined as preprocessor macros in
21
-
dt-bindings/clock/s5pv210.h header and can be used in device tree sources.
22
-
23
-
External clocks:
24
-
25
-
There are several clocks that are generated outside the SoC. It is expected
26
-
that they are defined using standard clock bindings with following
27
-
clock-output-names:
28
-
- "xxti": external crystal oscillator connected to XXTI and XXTO pins of
29
-
the SoC,
30
-
- "xusbxti": external crystal oscillator connected to XUSBXTI and XUSBXTO
31
-
pins of the SoC,
32
-
33
-
A subset of above clocks available on given board shall be specified in
34
-
board device tree, including the system base clock, as selected by XOM[0]
35
-
pin of the SoC. Refer to generic fixed rate clock bindings
36
-
documentation[1] for more information how to specify these clocks.
37
-
38
-
[1] Documentation/devicetree/bindings/clock/fixed-clock.yaml
39
-
40
-
Example: Clock controller node:
41
-
42
-
clock: clock-controller@7e00f000 {
43
-
compatible = "samsung,s5pv210-clock";
44
-
reg = <0x7e00f000 0x1000>;
45
-
#clock-cells = <1>;
46
-
};
47
-
48
-
Example: Required external clocks:
49
-
50
-
xxti: clock-xxti {
51
-
compatible = "fixed-clock";
52
-
clock-output-names = "xxti";
53
-
clock-frequency = <24000000>;
54
-
#clock-cells = <0>;
55
-
};
56
-
57
-
xusbxti: clock-xusbxti {
58
-
compatible = "fixed-clock";
59
-
clock-output-names = "xusbxti";
60
-
clock-frequency = <24000000>;
61
-
#clock-cells = <0>;
62
-
};
63
-
64
-
Example: UART controller node that consumes the clock generated by the clock
65
-
controller (refer to the standard clock bindings for information about
66
-
"clocks" and "clock-names" properties):
67
-
68
-
uart0: serial@e2900000 {
69
-
compatible = "samsung,s5pv210-uart";
70
-
reg = <0xe2900000 0x400>;
71
-
interrupt-parent = <&vic1>;
72
-
interrupts = <10>;
73
-
clock-names = "uart", "clk_uart_baud0",
74
-
"clk_uart_baud1";
75
-
clocks = <&clocks UART0>, <&clocks UART0>,
76
-
<&clocks SCLK_UART0>;
77
-
};
+79
Documentation/devicetree/bindings/clock/samsung,s5pv210-clock.yaml
+79
Documentation/devicetree/bindings/clock/samsung,s5pv210-clock.yaml
···
1
+
# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2
+
%YAML 1.2
3
+
---
4
+
$id: http://devicetree.org/schemas/clock/samsung,s5pv210-clock.yaml#
5
+
$schema: http://devicetree.org/meta-schemas/core.yaml#
6
+
7
+
title: Samsung S5P6442/S5PC110/S5PV210 SoC clock controller
8
+
9
+
maintainers:
10
+
- Chanwoo Choi <cw00.choi@samsung.com>
11
+
- Krzysztof Kozlowski <krzysztof.kozlowski@canonical.com>
12
+
- Sylwester Nawrocki <s.nawrocki@samsung.com>
13
+
- Tomasz Figa <tomasz.figa@gmail.com>
14
+
15
+
description: |
16
+
Expected external clocks, defined in DTS as fixed-rate clocks with a matching
17
+
name::
18
+
- "xxti" - external crystal oscillator connected to XXTI and XXTO pins of
19
+
the SoC,
20
+
- "xusbxti" - external crystal oscillator connected to XUSBXTI and XUSBXTO
21
+
pins of the SoC,
22
+
23
+
All available clocks are defined as preprocessor macros in
24
+
include/dt-bindings/clock/s5pv210.h header.
25
+
26
+
properties:
27
+
compatible:
28
+
enum:
29
+
- samsung,s5pv210-clock
30
+
- samsung,s5p6442-clock
31
+
32
+
clocks:
33
+
items:
34
+
- description: xxti clock
35
+
- description: xusbxti clock
36
+
37
+
clock-names:
38
+
items:
39
+
- const: xxti
40
+
- const: xusbxti
41
+
42
+
"#clock-cells":
43
+
const: 1
44
+
45
+
reg:
46
+
maxItems: 1
47
+
48
+
required:
49
+
- compatible
50
+
- "#clock-cells"
51
+
- reg
52
+
53
+
additionalProperties: false
54
+
55
+
examples:
56
+
- |
57
+
#include <dt-bindings/clock/s5pv210.h>
58
+
59
+
xxti: clock-0 {
60
+
compatible = "fixed-clock";
61
+
clock-frequency = <0>;
62
+
clock-output-names = "xxti";
63
+
#clock-cells = <0>;
64
+
};
65
+
66
+
xusbxti: clock-1 {
67
+
compatible = "fixed-clock";
68
+
clock-frequency = <0>;
69
+
clock-output-names = "xusbxti";
70
+
#clock-cells = <0>;
71
+
};
72
+
73
+
clock-controller@e0100000 {
74
+
compatible = "samsung,s5pv210-clock";
75
+
reg = <0xe0100000 0x10000>;
76
+
clock-names = "xxti", "xusbxti";
77
+
clocks = <&xxti>, <&xusbxti>;
78
+
#clock-cells = <1>;
79
+
};
-1
MAINTAINERS
-1
MAINTAINERS
···
16848
16848
T: git git://git.kernel.org/pub/scm/linux/kernel/git/snawrocki/clk.git
16849
16849
F: Documentation/devicetree/bindings/clock/samsung,*.yaml
16850
16850
F: Documentation/devicetree/bindings/clock/samsung,s3c*
16851
-
F: Documentation/devicetree/bindings/clock/samsung,s5p*
16852
16851
F: drivers/clk/samsung/
16853
16852
F: include/dt-bindings/clock/exynos*.h
16854
16853
F: include/dt-bindings/clock/s3c*.h