xref: /freebsd/sys/contrib/device-tree/Bindings/clock/st/st,quadfs.txt (revision 5956d97f4b3204318ceb6aa9c77bd0bc6ea87a41)
1c66ec88fSEmmanuel VadotBinding for a type of quad channel digital frequency synthesizer found on
2c66ec88fSEmmanuel Vadotcertain STMicroelectronics consumer electronics SoC devices.
3c66ec88fSEmmanuel Vadot
4c66ec88fSEmmanuel VadotThis version contains a programmable PLL which can generate up to 216, 432
5c66ec88fSEmmanuel Vadotor 660MHz (from a 30MHz oscillator input) as the input to the digital
6c66ec88fSEmmanuel Vadotsynthesizers.
7c66ec88fSEmmanuel Vadot
8c66ec88fSEmmanuel VadotThis binding uses the common clock binding[1].
9c66ec88fSEmmanuel Vadot
10c66ec88fSEmmanuel Vadot[1] Documentation/devicetree/bindings/clock/clock-bindings.txt
11c66ec88fSEmmanuel Vadot
12c66ec88fSEmmanuel VadotRequired properties:
13c66ec88fSEmmanuel Vadot- compatible : shall be:
14c66ec88fSEmmanuel Vadot  "st,quadfs"
15*5956d97fSEmmanuel Vadot  "st,quadfs-d0"
16*5956d97fSEmmanuel Vadot  "st,quadfs-d2"
17*5956d97fSEmmanuel Vadot  "st,quadfs-d3"
18c66ec88fSEmmanuel Vadot  "st,quadfs-pll"
19c66ec88fSEmmanuel Vadot
20c66ec88fSEmmanuel Vadot
21c66ec88fSEmmanuel Vadot- #clock-cells : from common clock binding; shall be set to 1.
22c66ec88fSEmmanuel Vadot
23c66ec88fSEmmanuel Vadot- reg : A Base address and length of the register set.
24c66ec88fSEmmanuel Vadot
25c66ec88fSEmmanuel Vadot- clocks : from common clock binding
26c66ec88fSEmmanuel Vadot
27c66ec88fSEmmanuel Vadot- clock-output-names : From common clock binding. The block has 4
28c66ec88fSEmmanuel Vadot                       clock outputs but not all of them in a specific instance
29c66ec88fSEmmanuel Vadot                       have to be used in the SoC. If a clock name is left as
30c66ec88fSEmmanuel Vadot                       an empty string then no clock will be created for the
31c66ec88fSEmmanuel Vadot                       output associated with that string index. If fewer than
32c66ec88fSEmmanuel Vadot                       4 strings are provided then no clocks will be created
33c66ec88fSEmmanuel Vadot                       for the remaining outputs.
34c66ec88fSEmmanuel Vadot
35c66ec88fSEmmanuel VadotExample:
36c66ec88fSEmmanuel Vadot
37c66ec88fSEmmanuel Vadot	clk_s_c0_quadfs: clk-s-c0-quadfs@9103000 {
38c66ec88fSEmmanuel Vadot		#clock-cells = <1>;
39c66ec88fSEmmanuel Vadot		compatible = "st,quadfs-pll";
40c66ec88fSEmmanuel Vadot		reg = <0x9103000 0x1000>;
41c66ec88fSEmmanuel Vadot
42c66ec88fSEmmanuel Vadot		clocks = <&clk_sysin>;
43c66ec88fSEmmanuel Vadot
44c66ec88fSEmmanuel Vadot		clock-output-names = "clk-s-c0-fs0-ch0",
45c66ec88fSEmmanuel Vadot				     "clk-s-c0-fs0-ch1",
46c66ec88fSEmmanuel Vadot				     "clk-s-c0-fs0-ch2",
47c66ec88fSEmmanuel Vadot				     "clk-s-c0-fs0-ch3";
48c66ec88fSEmmanuel Vadot	};
49