1d863dc9eSPurna Chandra MandalMicrochip PIC32 Clock Controller Binding
2d863dc9eSPurna Chandra Mandal----------------------------------------
3d863dc9eSPurna Chandra MandalMicrochip clock controller is consists of few oscillators, PLL, multiplexer
4d863dc9eSPurna Chandra Mandaland few divider modules.
5d863dc9eSPurna Chandra Mandal
6d863dc9eSPurna Chandra MandalThis binding uses common clock bindings.
7d863dc9eSPurna Chandra Mandal[1] Documentation/devicetree/bindings/clock/clock-bindings.txt
8d863dc9eSPurna Chandra Mandal
9d863dc9eSPurna Chandra MandalRequired properties:
10d863dc9eSPurna Chandra Mandal- compatible: shall be "microchip,pic32mzda-clk".
11d863dc9eSPurna Chandra Mandal- reg: shall contain base address and length of clock registers.
12d863dc9eSPurna Chandra Mandal- #clock-cells: shall be 1.
13d863dc9eSPurna Chandra Mandal
14d863dc9eSPurna Chandra MandalOptional properties:
15d863dc9eSPurna Chandra Mandal- microchip,pic32mzda-sosc: shall be added only if platform has
16d863dc9eSPurna Chandra Mandal  secondary oscillator connected.
17d863dc9eSPurna Chandra Mandal
18d863dc9eSPurna Chandra MandalExample:
19d863dc9eSPurna Chandra Mandal	rootclk: clock-controller@1f801200 {
20d863dc9eSPurna Chandra Mandal		compatible = "microchip,pic32mzda-clk";
21d863dc9eSPurna Chandra Mandal		reg = <0x1f801200 0x200>;
22d863dc9eSPurna Chandra Mandal		#clock-cells = <1>;
23d863dc9eSPurna Chandra Mandal		/* optional */
24d863dc9eSPurna Chandra Mandal		microchip,pic32mzda-sosc;
25d863dc9eSPurna Chandra Mandal	};
26d863dc9eSPurna Chandra Mandal
27d863dc9eSPurna Chandra Mandal
28d863dc9eSPurna Chandra MandalThe clock consumer shall specify the desired clock-output of the clock
29d863dc9eSPurna Chandra Mandalcontroller (as defined in [2]) by specifying output-id in its "clock"
30d863dc9eSPurna Chandra Mandalphandle cell.
31d863dc9eSPurna Chandra Mandal[2] include/dt-bindings/clock/microchip,pic32-clock.h
32d863dc9eSPurna Chandra Mandal
33d863dc9eSPurna Chandra MandalFor example for UART2:
34d863dc9eSPurna Chandra Mandaluart2: serial@2 {
35d863dc9eSPurna Chandra Mandal	compatible = "microchip,pic32mzda-uart";
36d863dc9eSPurna Chandra Mandal	reg = <>;
37d863dc9eSPurna Chandra Mandal	interrupts = <>;
38d863dc9eSPurna Chandra Mandal	clocks = <&rootclk PB2CLK>;
39d863dc9eSPurna Chandra Mandal};
40