Skip to content

Commit dc39d7f

Browse files
akemnadebebarino
authored andcommitted
dt-bindings: clock: ti: Convert composite.txt to json-schema
Convert the OMAP gate clock device tree binding to json-schema. Specify the creator of the original binding as a maintainer. Choose GPL-only license because original binding was also GPL. Signed-off-by: Andreas Kemnade <andreas@kemnade.info> Link: https://lore.kernel.org/r/20250105170854.408875-3-andreas@kemnade.info Reviewed-by: Rob Herring (Arm) <robh@kernel.org> Signed-off-by: Stephen Boyd <sboyd@kernel.org>
1 parent be7638a commit dc39d7f

File tree

2 files changed

+82
-55
lines changed

2 files changed

+82
-55
lines changed

Documentation/devicetree/bindings/clock/ti/composite.txt

Lines changed: 0 additions & 55 deletions
This file was deleted.
Lines changed: 82 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,82 @@
1+
# SPDX-License-Identifier: GPL-2.0-only
2+
%YAML 1.2
3+
---
4+
$id: http://devicetree.org/schemas/clock/ti/ti,composite-clock.yaml#
5+
$schema: http://devicetree.org/meta-schemas/core.yaml#
6+
7+
title: Texas Instruments composite clock
8+
9+
maintainers:
10+
- Tero Kristo <kristo@kernel.org>
11+
12+
description: |
13+
*Deprecated design pattern: one node per clock*
14+
15+
This binding assumes a register-mapped composite clock with multiple
16+
different sub-types:
17+
18+
a multiplexer clock with multiple input clock signals or parents, one
19+
of which can be selected as output, this behaves exactly as [1].
20+
21+
an adjustable clock rate divider, this behaves exactly as [2].
22+
23+
a gating function which can be used to enable and disable the output
24+
clock, this behaves exactly as [3].
25+
26+
The binding must provide a list of the component clocks that shall be
27+
merged to this clock. The component clocks shall be of one of the
28+
"ti,*composite*-clock" types.
29+
30+
[1] Documentation/devicetree/bindings/clock/ti/ti,mux-clock.yaml
31+
[2] Documentation/devicetree/bindings/clock/ti/ti,divider-clock.yaml
32+
[3] Documentation/devicetree/bindings/clock/ti/ti,gate-clock.yaml
33+
34+
properties:
35+
compatible:
36+
const: ti,composite-clock
37+
38+
"#clock-cells":
39+
const: 0
40+
41+
clocks: true
42+
43+
clock-output-names:
44+
maxItems: 1
45+
46+
required:
47+
- compatible
48+
- "#clock-cells"
49+
- clocks
50+
51+
additionalProperties: false
52+
53+
examples:
54+
- |
55+
bus {
56+
#address-cells = <1>;
57+
#size-cells = <0>;
58+
59+
usb_l4_gate_ick: clock-controller@a10 {
60+
#clock-cells = <0>;
61+
compatible = "ti,composite-gate-clock";
62+
clocks = <&l4_ick>;
63+
ti,bit-shift = <5>;
64+
reg = <0x0a10>;
65+
};
66+
67+
usb_l4_div_ick: clock-controller@a40 {
68+
#clock-cells = <0>;
69+
compatible = "ti,composite-divider-clock";
70+
clocks = <&l4_ick>;
71+
ti,bit-shift = <4>;
72+
ti,max-div = <1>;
73+
reg = <0x0a40>;
74+
ti,index-starts-at-one;
75+
};
76+
};
77+
78+
clock-controller {
79+
#clock-cells = <0>;
80+
compatible = "ti,composite-clock";
81+
clocks = <&usb_l4_gate_ick>, <&usb_l4_div_ick>;
82+
};

0 commit comments

Comments
 (0)