Linux kernel mirror (for testing)
git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel
os
linux
dt-bindings: clock: Convert silabs,si570 to DT schema
Convert the Silicon Labs SI570 binding to DT schema format. It's a
straight-forward conversion.
Signed-off-by: Rob Herring (Arm) <robh@kernel.org>
Link: https://lore.kernel.org/r/20250804222010.4082782-1-robh@kernel.org
Reviewed-by: Krzysztof Kozlowski <krzysztof.kozlowski@linaro.org>
Signed-off-by: Stephen Boyd <sboyd@kernel.org>
authored by
Rob Herring (Arm)
and committed by
Stephen Boyd
7513cc39
b02011c8
+80
-41
-41
Documentation/devicetree/bindings/clock/silabs,si570.txt
-41
Documentation/devicetree/bindings/clock/silabs,si570.txt
···
1
-
Binding for Silicon Labs 570, 571, 598 and 599 programmable
2
-
I2C clock generators.
3
-
4
-
Reference
5
-
This binding uses the common clock binding[1]. Details about the devices can be
6
-
found in the data sheets[2][3].
7
-
8
-
[1] Documentation/devicetree/bindings/clock/clock-bindings.txt
9
-
[2] Si570/571 Data Sheet
10
-
https://www.silabs.com/Support%20Documents/TechnicalDocs/si570.pdf
11
-
[3] Si598/599 Data Sheet
12
-
https://www.silabs.com/Support%20Documents/TechnicalDocs/si598-99.pdf
13
-
14
-
Required properties:
15
-
- compatible: Shall be one of "silabs,si570", "silabs,si571",
16
-
"silabs,si598", "silabs,si599"
17
-
- reg: I2C device address.
18
-
- #clock-cells: From common clock bindings: Shall be 0.
19
-
- factory-fout: Factory set default frequency. This frequency is part specific.
20
-
The correct frequency for the part used has to be provided in
21
-
order to generate the correct output frequencies. For more
22
-
details, please refer to the data sheet.
23
-
- temperature-stability: Temperature stability of the device in PPM. Should be
24
-
one of: 7, 20, 50 or 100.
25
-
26
-
Optional properties:
27
-
- clock-output-names: From common clock bindings. Recommended to be "si570".
28
-
- clock-frequency: Output frequency to generate. This defines the output
29
-
frequency set during boot. It can be reprogrammed during
30
-
runtime through the common clock framework.
31
-
- silabs,skip-recall: Do not perform NVM->RAM recall operation. It will rely
32
-
on hardware loading of RAM from NVM at power on.
33
-
34
-
Example:
35
-
si570: clock-generator@5d {
36
-
#clock-cells = <0>;
37
-
compatible = "silabs,si570";
38
-
temperature-stability = <50>;
39
-
reg = <0x5d>;
40
-
factory-fout = <156250000>;
41
-
};
+80
Documentation/devicetree/bindings/clock/silabs,si570.yaml
+80
Documentation/devicetree/bindings/clock/silabs,si570.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/silabs,si570.yaml#
5
+
$schema: http://devicetree.org/meta-schemas/core.yaml#
6
+
7
+
title: Silicon Labs Si570/Si571/Si598/Si599 programmable I2C clock generator
8
+
9
+
maintainers:
10
+
- Soren Brinkmann <soren.brinkmann@xilinx.com>
11
+
12
+
description: >
13
+
Silicon Labs 570, 571, 598 and 599 programmable I2C clock generators. Details
14
+
about the devices can be found in the data sheets[1][2].
15
+
16
+
[1] Si570/571 Data Sheet
17
+
https://www.silabs.com/Support%20Documents/TechnicalDocs/si570.pdf
18
+
[2] Si598/599 Data Sheet
19
+
https://www.silabs.com/Support%20Documents/TechnicalDocs/si598-99.pdf
20
+
21
+
properties:
22
+
compatible:
23
+
enum:
24
+
- silabs,si570
25
+
- silabs,si571
26
+
- silabs,si598
27
+
- silabs,si599
28
+
29
+
reg:
30
+
maxItems: 1
31
+
32
+
'#clock-cells':
33
+
const: 0
34
+
35
+
factory-fout:
36
+
description: Factory-set default frequency in Hz.
37
+
$ref: /schemas/types.yaml#/definitions/uint32
38
+
39
+
temperature-stability:
40
+
description: Temperature stability of the device in PPM.
41
+
$ref: /schemas/types.yaml#/definitions/uint32
42
+
enum:
43
+
- 7
44
+
- 20
45
+
- 50
46
+
- 100
47
+
48
+
clock-output-names:
49
+
maxItems: 1
50
+
51
+
clock-frequency:
52
+
description: Output frequency to generate at boot; can be reprogrammed at runtime.
53
+
54
+
silabs,skip-recall:
55
+
description: Skip the NVM-to-RAM recall operation during boot.
56
+
type: boolean
57
+
58
+
required:
59
+
- compatible
60
+
- reg
61
+
- '#clock-cells'
62
+
- factory-fout
63
+
- temperature-stability
64
+
65
+
additionalProperties: false
66
+
67
+
examples:
68
+
- |
69
+
i2c {
70
+
#address-cells = <1>;
71
+
#size-cells = <0>;
72
+
73
+
clock-generator@5d {
74
+
compatible = "silabs,si570";
75
+
reg = <0x5d>;
76
+
#clock-cells = <0>;
77
+
temperature-stability = <50>;
78
+
factory-fout = <156250000>;
79
+
};
80
+
};