162306a36Sopenharmony_ciMicrochip PIC32 Clock Controller Binding
262306a36Sopenharmony_ci----------------------------------------
362306a36Sopenharmony_ciMicrochip clock controller is consists of few oscillators, PLL, multiplexer
462306a36Sopenharmony_ciand few divider modules.
562306a36Sopenharmony_ci
662306a36Sopenharmony_ciThis binding uses common clock bindings.
762306a36Sopenharmony_ci[1] Documentation/devicetree/bindings/clock/clock-bindings.txt
862306a36Sopenharmony_ci
962306a36Sopenharmony_ciRequired properties:
1062306a36Sopenharmony_ci- compatible: shall be "microchip,pic32mzda-clk".
1162306a36Sopenharmony_ci- reg: shall contain base address and length of clock registers.
1262306a36Sopenharmony_ci- #clock-cells: shall be 1.
1362306a36Sopenharmony_ci
1462306a36Sopenharmony_ciOptional properties:
1562306a36Sopenharmony_ci- microchip,pic32mzda-sosc: shall be added only if platform has
1662306a36Sopenharmony_ci  secondary oscillator connected.
1762306a36Sopenharmony_ci
1862306a36Sopenharmony_ciExample:
1962306a36Sopenharmony_ci	rootclk: clock-controller@1f801200 {
2062306a36Sopenharmony_ci		compatible = "microchip,pic32mzda-clk";
2162306a36Sopenharmony_ci		reg = <0x1f801200 0x200>;
2262306a36Sopenharmony_ci		#clock-cells = <1>;
2362306a36Sopenharmony_ci		/* optional */
2462306a36Sopenharmony_ci		microchip,pic32mzda-sosc;
2562306a36Sopenharmony_ci	};
2662306a36Sopenharmony_ci
2762306a36Sopenharmony_ci
2862306a36Sopenharmony_ciThe clock consumer shall specify the desired clock-output of the clock
2962306a36Sopenharmony_cicontroller (as defined in [2]) by specifying output-id in its "clock"
3062306a36Sopenharmony_ciphandle cell.
3162306a36Sopenharmony_ci[2] include/dt-bindings/clock/microchip,pic32-clock.h
3262306a36Sopenharmony_ci
3362306a36Sopenharmony_ciFor example for UART2:
3462306a36Sopenharmony_ciuart2: serial@2 {
3562306a36Sopenharmony_ci	compatible = "microchip,pic32mzda-uart";
3662306a36Sopenharmony_ci	reg = <>;
3762306a36Sopenharmony_ci	interrupts = <>;
3862306a36Sopenharmony_ci	clocks = <&rootclk PB2CLK>;
3962306a36Sopenharmony_ci};
40