18c2ecf20Sopenharmony_ciMicrochip PIC32 Clock Controller Binding
28c2ecf20Sopenharmony_ci----------------------------------------
38c2ecf20Sopenharmony_ciMicrochip clock controller is consists of few oscillators, PLL, multiplexer
48c2ecf20Sopenharmony_ciand few divider modules.
58c2ecf20Sopenharmony_ci
68c2ecf20Sopenharmony_ciThis binding uses common clock bindings.
78c2ecf20Sopenharmony_ci[1] Documentation/devicetree/bindings/clock/clock-bindings.txt
88c2ecf20Sopenharmony_ci
98c2ecf20Sopenharmony_ciRequired properties:
108c2ecf20Sopenharmony_ci- compatible: shall be "microchip,pic32mzda-clk".
118c2ecf20Sopenharmony_ci- reg: shall contain base address and length of clock registers.
128c2ecf20Sopenharmony_ci- #clock-cells: shall be 1.
138c2ecf20Sopenharmony_ci
148c2ecf20Sopenharmony_ciOptional properties:
158c2ecf20Sopenharmony_ci- microchip,pic32mzda-sosc: shall be added only if platform has
168c2ecf20Sopenharmony_ci  secondary oscillator connected.
178c2ecf20Sopenharmony_ci
188c2ecf20Sopenharmony_ciExample:
198c2ecf20Sopenharmony_ci	rootclk: clock-controller@1f801200 {
208c2ecf20Sopenharmony_ci		compatible = "microchip,pic32mzda-clk";
218c2ecf20Sopenharmony_ci		reg = <0x1f801200 0x200>;
228c2ecf20Sopenharmony_ci		#clock-cells = <1>;
238c2ecf20Sopenharmony_ci		/* optional */
248c2ecf20Sopenharmony_ci		microchip,pic32mzda-sosc;
258c2ecf20Sopenharmony_ci	};
268c2ecf20Sopenharmony_ci
278c2ecf20Sopenharmony_ci
288c2ecf20Sopenharmony_ciThe clock consumer shall specify the desired clock-output of the clock
298c2ecf20Sopenharmony_cicontroller (as defined in [2]) by specifying output-id in its "clock"
308c2ecf20Sopenharmony_ciphandle cell.
318c2ecf20Sopenharmony_ci[2] include/dt-bindings/clock/microchip,pic32-clock.h
328c2ecf20Sopenharmony_ci
338c2ecf20Sopenharmony_ciFor example for UART2:
348c2ecf20Sopenharmony_ciuart2: serial@2 {
358c2ecf20Sopenharmony_ci	compatible = "microchip,pic32mzda-uart";
368c2ecf20Sopenharmony_ci	reg = <>;
378c2ecf20Sopenharmony_ci	interrupts = <>;
388c2ecf20Sopenharmony_ci	clocks = <&rootclk PB2CLK>;
398c2ecf20Sopenharmony_ci};
40