Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
148 changes: 137 additions & 11 deletions Documentation/devicetree/bindings/clock/google,zumapro-clock.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -11,10 +11,23 @@ maintainers:

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.
path in CMU_PERIC0. CMU_TOP also provides the HSI0 parent rate paths, the
four camera sensor master clocks (CIS_CLK0-3) and the camera front end's
NoC clock.
CMU_MISC supplies the firmware-owned watchdog bus clock paths.
CMU_HSI0 supplies the USB, eUSB2 PHY and touchscreen USI2 clocks; its
ALT and TCXO inputs are board-level fixed clocks.
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, touchscreen USI2 and GNSS SPI USI3
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 +36,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 +73,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 +104,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 +169,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 +260,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