Skip to content
140 changes: 132 additions & 8 deletions Documentation/devicetree/bindings/clock/google,zumapro-clock.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -13,8 +13,19 @@ description: |
CMU_TOP supplies the NoC and UFS clock paths to CMU_HSI2 and the supply-GPIO
path in CMU_PERIC0. CMU_TOP also provides the HSI0 parent rate paths.
CMU_MISC supplies the firmware-owned watchdog bus clock paths.
CMU_PERIC0 supplies its GPIO bank and USI2-USI6 (the cameras' and the
battery's I2C buses), the USIs from CMU_TOP's optional PERIC0 IP clock.
CMU_HSI0 supplies the USB, eUSB2 PHY and touchscreen USI2 clocks; its
ALT and TCXO inputs are board-level fixed clocks.
CMU_G3D supplies the GPU's core, coregroup and stacks clocks from its two
PLLs and CMU_TOP's G3D NoC, global and switch clocks.
CMU_HSI1 supplies the HSI1 GPIO bank's clock; its ALT input is a
board-level fixed clock.
CMU_APM supplies the always-on GPIO banks, the APM mailbox and its
internal memory from the always-on ALV PLL and the oscillator.
CMU_PERIC1 supplies the PERIC1 GPIO bank and USI9 (the I2C bus of the
NFC controller and the haptics driver) from CMU_TOP's PERIC1 NoC and IP
clocks.
The external oscillator supplies the PLL reference and oscillator mux
paths.
Clock identifiers are defined in dt-bindings/clock/google,zumapro.h.
Expand All @@ -23,9 +34,13 @@ properties:
compatible:
enum:
- google,zumapro-cmu-top
- google,zumapro-cmu-apm
- google,zumapro-cmu-g3d
- google,zumapro-cmu-hsi0
- google,zumapro-cmu-hsi1
- google,zumapro-cmu-hsi2
- google,zumapro-cmu-peric0
- google,zumapro-cmu-peric1
- google,zumapro-cmu-misc

reg:
Expand Down Expand Up @@ -56,7 +71,9 @@ allOf:
- if:
properties:
compatible:
const: google,zumapro-cmu-top
enum:
- google,zumapro-cmu-top
- google,zumapro-cmu-apm
then:
properties:
clocks:
Expand Down Expand Up @@ -85,9 +102,50 @@ allOf:
- const: peri
- const: alt
- const: tcxo
else:
- if:
properties:
compatible:
const: google,zumapro-cmu-hsi1
then:
properties:
clocks:
items:
- description: External oscillator reference clock
- description: HSI1 NoC clock from CMU_TOP
- description: HSI1 ALT input clock
clock-names:
items:
- const: oscclk
- const: bus
- const: alt
- if:
properties:
compatible:
not:
enum:
- google,zumapro-cmu-hsi0
- google,zumapro-cmu-hsi1
then:
properties:
power-domains: false
- if:
properties:
compatible:
const: google,zumapro-cmu-g3d
then:
properties:
clocks:
items:
- description: External oscillator reference clock
- description: G3D NoC clock from CMU_TOP
- description: G3D global clock from CMU_TOP
- description: G3D switch clock from CMU_TOP
clock-names:
items:
- const: oscclk
- const: bus
- const: glb
- const: switch
- if:
properties:
compatible:
Expand All @@ -109,9 +167,41 @@ allOf:
- if:
properties:
compatible:
enum:
- google,zumapro-cmu-peric0
- google,zumapro-cmu-misc
const: google,zumapro-cmu-peric1
then:
properties:
clocks:
items:
- description: External oscillator reference clock
- description: PERIC1 NoC clock from CMU_TOP
- description: PERIC1 USI input clock from CMU_TOP
clock-names:
items:
- const: oscclk
- const: bus
- const: ip
- if:
properties:
compatible:
const: google,zumapro-cmu-peric0
then:
properties:
clocks:
minItems: 2
items:
- description: External oscillator reference clock
- description: PERIC0 NoC clock from CMU_TOP
- description: PERIC0 USI input clock from CMU_TOP
clock-names:
minItems: 2
items:
- const: oscclk
- const: bus
- const: ip
- if:
properties:
compatible:
const: google,zumapro-cmu-misc
then:
properties:
clocks:
Expand Down Expand Up @@ -168,8 +258,42 @@ examples:
compatible = "google,zumapro-cmu-peric0";
reg = <0x10800000 0x8000>;
#clock-cells = <1>;
clocks = <&oscclk>, <&cmu_top CLK_DOUT_PERIC0_NOC>;
clock-names = "oscclk", "bus";
clocks = <&oscclk>, <&cmu_top CLK_DOUT_PERIC0_NOC>,
<&cmu_top CLK_DOUT_PERIC0_IP>;
clock-names = "oscclk", "bus", "ip";
};

clock-controller@12000000 {
compatible = "google,zumapro-cmu-hsi1";
reg = <0x12000000 0x8000>;
#clock-cells = <1>;
clocks = <&oscclk>, <&cmu_top CLK_DOUT_HSI1_NOC>, <&hsi1_alt>;
clock-names = "oscclk", "bus", "alt";
};

clock-controller@10c00000 {
compatible = "google,zumapro-cmu-peric1";
reg = <0x10c00000 0x8000>;
#clock-cells = <1>;
clocks = <&oscclk>, <&cmu_top CLK_DOUT_PERIC1_NOC>,
<&cmu_top CLK_DOUT_PERIC1_IP>;
clock-names = "oscclk", "bus", "ip";
};
...

clock-controller@15400000 {
compatible = "google,zumapro-cmu-apm";
reg = <0x15400000 0x8000>;
#clock-cells = <1>;
clocks = <&oscclk>;
clock-names = "oscclk";
};

clock-controller@1ee00000 {
compatible = "google,zumapro-cmu-g3d";
reg = <0x1ee00000 0x8000>;
#clock-cells = <1>;
clocks = <&oscclk>, <&cmu_top CLK_DOUT_G3D_NOCD>,
<&cmu_top CLK_DOUT_G3D_GLB>, <&cmu_top CLK_DOUT_G3D_SWITCH>;
clock-names = "oscclk", "bus", "glb", "switch";
};
...
Loading