Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux

dt-bindings: Add en7523-scu device tree binding documentation

Adds device tree binding documentation for clocks in the EN7523 SOC.

Reviewed-by: Rob Herring <robh@kernel.org>
Signed-off-by: John Crispin <john@phrozen.org>
Signed-off-by: Felix Fietkau <nbd@nbd.name>
Link: https://lore.kernel.org/r/20220314084409.84394-2-nbd@nbd.name
Signed-off-by: Stephen Boyd <sboyd@kernel.org>

authored by

John Crispin and committed by
Stephen Boyd
038010bb 31231092

+75
+58
Documentation/devicetree/bindings/clock/airoha,en7523-scu.yaml
··· 1 + # SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) 2 + %YAML 1.2 3 + --- 4 + $id: http://devicetree.org/schemas/clock/airoha,en7523-scu.yaml# 5 + $schema: http://devicetree.org/meta-schemas/core.yaml# 6 + 7 + title: EN7523 Clock Device Tree Bindings 8 + 9 + maintainers: 10 + - Felix Fietkau <nbd@nbd.name> 11 + - John Crispin <nbd@nbd.name> 12 + 13 + description: | 14 + This node defines the System Control Unit of the EN7523 SoC, 15 + a collection of registers configuring many different aspects of the SoC. 16 + 17 + The clock driver uses it to read and configure settings of the 18 + PLL controller, which provides clocks for the CPU, the bus and 19 + other SoC internal peripherals. 20 + 21 + Each clock is assigned an identifier and client nodes use this identifier 22 + to specify which clock they consume. 23 + 24 + All these identifiers can be found in: 25 + [1]: <include/dt-bindings/clock/en7523-clk.h>. 26 + 27 + The clocks are provided inside a system controller node. 28 + 29 + properties: 30 + compatible: 31 + items: 32 + - const: airoha,en7523-scu 33 + 34 + reg: 35 + maxItems: 2 36 + 37 + "#clock-cells": 38 + description: 39 + The first cell indicates the clock number, see [1] for available 40 + clocks. 41 + const: 1 42 + 43 + required: 44 + - compatible 45 + - reg 46 + - '#clock-cells' 47 + 48 + additionalProperties: false 49 + 50 + examples: 51 + - | 52 + #include <dt-bindings/clock/en7523-clk.h> 53 + scu: system-controller@1fa20000 { 54 + compatible = "airoha,en7523-scu"; 55 + reg = <0x1fa20000 0x400>, 56 + <0x1fb00000 0x1000>; 57 + #clock-cells = <1>; 58 + };
+17
include/dt-bindings/clock/en7523-clk.h
··· 1 + /* SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) */ 2 + 3 + #ifndef _DT_BINDINGS_CLOCK_AIROHA_EN7523_H_ 4 + #define _DT_BINDINGS_CLOCK_AIROHA_EN7523_H_ 5 + 6 + #define EN7523_CLK_GSW 0 7 + #define EN7523_CLK_EMI 1 8 + #define EN7523_CLK_BUS 2 9 + #define EN7523_CLK_SLIC 3 10 + #define EN7523_CLK_SPI 4 11 + #define EN7523_CLK_NPU 5 12 + #define EN7523_CLK_CRYPTO 6 13 + #define EN7523_CLK_PCIE 7 14 + 15 + #define EN7523_NUM_CLOCKS 8 16 + 17 + #endif /* _DT_BINDINGS_CLOCK_AIROHA_EN7523_H_ */