These gated clocks are found on Apple SoCs, such as the M1, and are required to enable access to MMIO regions of various peripherals. Signed-off-by: Sven Peter <sven@xxxxxxxxxxxxx> --- .../bindings/clock/apple,gate-clock.yaml | 60 +++++++++++++++++++ MAINTAINERS | 1 + 2 files changed, 61 insertions(+) create mode 100644 Documentation/devicetree/bindings/clock/apple,gate-clock.yaml diff --git a/Documentation/devicetree/bindings/clock/apple,gate-clock.yaml b/Documentation/devicetree/bindings/clock/apple,gate-clock.yaml new file mode 100644 index 000000000000..3aae47c40b42 --- /dev/null +++ b/Documentation/devicetree/bindings/clock/apple,gate-clock.yaml @@ -0,0 +1,60 @@ +# SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/clock/apple,gate-clock.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: Binding for Apple clock gates + +maintainers: + - Sven Peter <sven@xxxxxxxxxxxxx> + +description: | + Apple SoC's such as the M1 contain various clock gates. + These clock gates do not have a frequency associated with them and are only + used to power on/off various peripherals. Generally, a clock gate needs to + be enabled before the respective MMIO region can be accessed. + + Each clock gate is configured by a single 32bit MMIO register which contains + the actual and the target state. The state is encoded as four bits but + right now only "powered on" / 0b1111 and "powered off" / 0b0000 are used. + + +properties: + compatible: + enum: + - apple,t8103-gate-clock + - apple,gate-clock + + "#clock-cells": + const: 0 + + reg: + maxItems: 1 + + clocks: + maxItems: 1 + + clock-names: + maxItems: 1 + + clock-output-names: + maxItems: 1 + +required: + - compatible + - reg + - clock-output-names + - "#clock-cells" + +additionalProperties: false + +examples: + - | + clock@3b7001c0 { + compatible = "apple,t8103-gate-clock"; + reg = <0x3b7001c0 0x4>; + #clock-cells = <0>; + clock-output-names = "sio_busif_clk"; + }; +... diff --git a/MAINTAINERS b/MAINTAINERS index 008fcad7ac00..59c026ce4d73 100644 --- a/MAINTAINERS +++ b/MAINTAINERS @@ -1654,6 +1654,7 @@ B: https://github.com/AsahiLinux/linux/issues C: irc://chat.freenode.net/asahi-dev T: git https://github.com/AsahiLinux/linux.git F: Documentation/devicetree/bindings/arm/apple.yaml +F: Documentation/devicetree/bindings/clock/apple,gate-clock.yaml F: Documentation/devicetree/bindings/interrupt-controller/apple,aic.yaml F: arch/arm64/boot/dts/apple/ F: drivers/irqchip/irq-apple-aic.c -- 2.25.1
