1 # SPDX-License-Identifier: (GPL-2.0-only OR BS 1 # SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2 %YAML 1.2 2 %YAML 1.2
3 --- 3 ---
4 $id: http://devicetree.org/schemas/clock/ti,lm 4 $id: http://devicetree.org/schemas/clock/ti,lmk04832.yaml#
5 $schema: http://devicetree.org/meta-schemas/co 5 $schema: http://devicetree.org/meta-schemas/core.yaml#
6 6
7 title: Texas Instruments LMK04832 Clock Contro 7 title: Texas Instruments LMK04832 Clock Controller
8 8
9 maintainers: 9 maintainers:
10 - Liam Beguin <liambeguin@gmail.com> 10 - Liam Beguin <liambeguin@gmail.com>
11 11
12 description: | 12 description: |
13 Devicetree binding for the LMK04832, a clock 13 Devicetree binding for the LMK04832, a clock conditioner with JEDEC JESD204B
14 support. The LMK04832 is pin compatible with 14 support. The LMK04832 is pin compatible with the LMK0482x family.
15 15
16 Link to datasheet, https://www.ti.com/lit/ds 16 Link to datasheet, https://www.ti.com/lit/ds/symlink/lmk04832.pdf
17 17
18 properties: 18 properties:
19 compatible: 19 compatible:
20 enum: 20 enum:
21 - ti,lmk04832 21 - ti,lmk04832
22 22
23 reg: 23 reg:
24 maxItems: 1 24 maxItems: 1
25 25
26 '#address-cells': 26 '#address-cells':
27 const: 1 27 const: 1
28 28
29 '#size-cells': 29 '#size-cells':
30 const: 0 30 const: 0
31 31
32 '#clock-cells': 32 '#clock-cells':
33 const: 1 33 const: 1
34 34
35 spi-max-frequency: 35 spi-max-frequency:
36 maximum: 5000000 36 maximum: 5000000
37 37
38 clocks: 38 clocks:
39 items: 39 items:
40 - description: PLL2 reference clock. 40 - description: PLL2 reference clock.
41 41
42 clock-names: 42 clock-names:
43 items: 43 items:
44 - const: oscin 44 - const: oscin
45 45
46 reset-gpios: 46 reset-gpios:
47 maxItems: 1 47 maxItems: 1
48 48
49 ti,spi-4wire-rdbk: 49 ti,spi-4wire-rdbk:
50 description: | 50 description: |
51 Select SPI 4wire readback pin configurat 51 Select SPI 4wire readback pin configuration.
52 Available readback pins are, 52 Available readback pins are,
53 CLKin_SEL0 0 53 CLKin_SEL0 0
54 CLKin_SEL1 1 54 CLKin_SEL1 1
55 RESET 2 55 RESET 2
56 $ref: /schemas/types.yaml#/definitions/uin 56 $ref: /schemas/types.yaml#/definitions/uint32
57 enum: [0, 1, 2] 57 enum: [0, 1, 2]
58 default: 1 58 default: 1
59 59
60 ti,vco-hz: 60 ti,vco-hz:
61 description: Optional to set VCO frequency 61 description: Optional to set VCO frequency of the PLL in Hertz.
62 62
63 ti,sysref-ddly: 63 ti,sysref-ddly:
64 description: SYSREF digital delay value. 64 description: SYSREF digital delay value.
65 $ref: /schemas/types.yaml#/definitions/uin 65 $ref: /schemas/types.yaml#/definitions/uint32
66 minimum: 8 66 minimum: 8
67 maximum: 8191 67 maximum: 8191
68 default: 8 68 default: 8
69 69
70 ti,sysref-mux: 70 ti,sysref-mux:
71 description: | 71 description: |
72 SYSREF Mux configuration. 72 SYSREF Mux configuration.
73 Available options are, 73 Available options are,
74 Normal SYNC 0 74 Normal SYNC 0
75 Re-clocked 1 75 Re-clocked 1
76 SYSREF Pulser 2 76 SYSREF Pulser 2
77 SYSREF Continuous 3 77 SYSREF Continuous 3
78 $ref: /schemas/types.yaml#/definitions/uin 78 $ref: /schemas/types.yaml#/definitions/uint32
79 enum: [0, 1, 2, 3] 79 enum: [0, 1, 2, 3]
80 default: 3 80 default: 3
81 81
82 ti,sync-mode: 82 ti,sync-mode:
83 description: SYNC pin configuration. 83 description: SYNC pin configuration.
84 $ref: /schemas/types.yaml#/definitions/uin 84 $ref: /schemas/types.yaml#/definitions/uint32
85 enum: [0, 1, 2] 85 enum: [0, 1, 2]
86 default: 1 86 default: 1
87 87
88 ti,sysref-pulse-count: 88 ti,sysref-pulse-count:
89 description: 89 description:
90 Number of SYSREF pulses to send when SYS 90 Number of SYSREF pulses to send when SYSREF is not in continuous mode.
91 $ref: /schemas/types.yaml#/definitions/uin 91 $ref: /schemas/types.yaml#/definitions/uint32
92 enum: [1, 2, 4, 8] 92 enum: [1, 2, 4, 8]
93 default: 4 93 default: 4
94 94
95 patternProperties: 95 patternProperties:
96 "@[0-9a-d]+$": 96 "@[0-9a-d]+$":
97 type: object 97 type: object
98 description: 98 description:
99 Child nodes used to configure output clo 99 Child nodes used to configure output clocks.
100 100
101 properties: 101 properties:
102 reg: 102 reg:
103 description: 103 description:
104 clock output identifier. 104 clock output identifier.
105 minimum: 0 105 minimum: 0
106 maximum: 13 106 maximum: 13
107 107
108 ti,clkout-fmt: 108 ti,clkout-fmt:
109 description: 109 description:
110 Clock output format. 110 Clock output format.
111 Available options are, 111 Available options are,
112 Powerdown 0x00 112 Powerdown 0x00
113 LVDS 0x01 113 LVDS 0x01
114 HSDS 6 mA 0x02 114 HSDS 6 mA 0x02
115 HSDS 8 mA 0x03 115 HSDS 8 mA 0x03
116 LVPECL 1600 mV 0x04 116 LVPECL 1600 mV 0x04
117 LVPECL 2000 mV 0x05 117 LVPECL 2000 mV 0x05
118 LCPECL 0x06 118 LCPECL 0x06
119 CML 16 mA 0x07 119 CML 16 mA 0x07
120 CML 24 mA 0x08 120 CML 24 mA 0x08
121 CML 32 mA 0x09 121 CML 32 mA 0x09
122 CMOS (Off/Inverted) 0x0a 122 CMOS (Off/Inverted) 0x0a
123 CMOS (Normal/Off) 0x0b 123 CMOS (Normal/Off) 0x0b
124 CMOS (Inverted/Inverted) 0x0c 124 CMOS (Inverted/Inverted) 0x0c
125 CMOS (Inverted/Normal) 0x0d 125 CMOS (Inverted/Normal) 0x0d
126 CMOS (Normal/Inverted) 0x0e 126 CMOS (Normal/Inverted) 0x0e
127 CMOS (Normal/Normal) 0x0f 127 CMOS (Normal/Normal) 0x0f
128 $ref: /schemas/types.yaml#/definitions 128 $ref: /schemas/types.yaml#/definitions/uint32
129 minimum: 0 129 minimum: 0
130 maximum: 15 130 maximum: 15
131 131
132 ti,clkout-sysref: 132 ti,clkout-sysref:
133 description: 133 description:
134 Select SYSREF clock path for output 134 Select SYSREF clock path for output clock.
135 type: boolean 135 type: boolean
136 136
137 required: 137 required:
138 - reg 138 - reg
139 139
140 additionalProperties: false 140 additionalProperties: false
141 141
142 required: 142 required:
143 - compatible 143 - compatible
144 - reg 144 - reg
145 - '#clock-cells' 145 - '#clock-cells'
146 - clocks 146 - clocks
147 - clock-names 147 - clock-names
148 148
149 additionalProperties: false 149 additionalProperties: false
150 150
151 examples: 151 examples:
152 - | 152 - |
153 clocks { 153 clocks {
154 lmk04832_oscin: oscin { 154 lmk04832_oscin: oscin {
155 compatible = "fixed-clock"; 155 compatible = "fixed-clock";
156 156
157 #clock-cells = <0>; 157 #clock-cells = <0>;
158 clock-frequency = <122880000>; 158 clock-frequency = <122880000>;
159 clock-output-names = "lmk04832-osc 159 clock-output-names = "lmk04832-oscin";
160 }; 160 };
161 }; 161 };
162 162
163 spi { 163 spi {
164 #address-cells = <1>; 164 #address-cells = <1>;
165 #size-cells = <0>; 165 #size-cells = <0>;
166 166
167 lmk04832: clock-controller@0 { 167 lmk04832: clock-controller@0 {
168 #address-cells = <1>; 168 #address-cells = <1>;
169 #size-cells = <0>; 169 #size-cells = <0>;
170 170
171 reg = <0>; 171 reg = <0>;
172 172
173 compatible = "ti,lmk04832"; 173 compatible = "ti,lmk04832";
174 spi-max-frequency = <781250>; 174 spi-max-frequency = <781250>;
175 175
176 reset-gpios = <&gpio_lmk 0 0 0>; 176 reset-gpios = <&gpio_lmk 0 0 0>;
177 177
178 #clock-cells = <1>; 178 #clock-cells = <1>;
179 clocks = <&lmk04832_oscin>; 179 clocks = <&lmk04832_oscin>;
180 clock-names = "oscin"; 180 clock-names = "oscin";
181 181
182 ti,spi-4wire-rdbk = <0>; 182 ti,spi-4wire-rdbk = <0>;
183 ti,vco-hz = <2457600000>; 183 ti,vco-hz = <2457600000>;
184 184
185 assigned-clocks = 185 assigned-clocks =
186 <&lmk04832 0>, <&lmk04832 1>, 186 <&lmk04832 0>, <&lmk04832 1>,
187 <&lmk04832 2>, <&lmk04832 3>, 187 <&lmk04832 2>, <&lmk04832 3>,
188 <&lmk04832 4>, 188 <&lmk04832 4>,
189 <&lmk04832 6>, <&lmk04832 7>, 189 <&lmk04832 6>, <&lmk04832 7>,
190 <&lmk04832 10>, <&lmk04832 11> 190 <&lmk04832 10>, <&lmk04832 11>;
191 assigned-clock-rates = 191 assigned-clock-rates =
192 <122880000>, <384000>, 192 <122880000>, <384000>,
193 <122880000>, <384000>, 193 <122880000>, <384000>,
194 <122880000>, 194 <122880000>,
195 <153600000>, <384000>, 195 <153600000>, <384000>,
196 <614400000>, <384000>; 196 <614400000>, <384000>;
197 197
198 clkout0@0 { 198 clkout0@0 {
199 reg = <0>; 199 reg = <0>;
200 ti,clkout-fmt = <0x01>; // LVD 200 ti,clkout-fmt = <0x01>; // LVDS
201 }; 201 };
202 202
203 clkout1@1 { 203 clkout1@1 {
204 reg = <1>; 204 reg = <1>;
205 ti,clkout-fmt = <0x01>; // LVD 205 ti,clkout-fmt = <0x01>; // LVDS
206 ti,clkout-sysref; 206 ti,clkout-sysref;
207 }; 207 };
208 }; 208 };
209 }; 209 };
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.