aboutsummaryrefslogtreecommitdiffstats
path: root/Documentation/devicetree/bindings/clock/brcm,kona-ccu.txt
diff options
context:
space:
mode:
Diffstat (limited to 'Documentation/devicetree/bindings/clock/brcm,kona-ccu.txt')
-rw-r--r--Documentation/devicetree/bindings/clock/brcm,kona-ccu.txt139
1 files changed, 139 insertions, 0 deletions
diff --git a/Documentation/devicetree/bindings/clock/brcm,kona-ccu.txt b/Documentation/devicetree/bindings/clock/brcm,kona-ccu.txt
new file mode 100644
index 000000000000..5286e260fcae
--- /dev/null
+++ b/Documentation/devicetree/bindings/clock/brcm,kona-ccu.txt
@@ -0,0 +1,139 @@
1Broadcom Kona Family Clocks
2
3This binding is associated with Broadcom SoCs having "Kona" style
4clock control units (CCUs). A CCU is a clock provider that manages
5a set of clock signals. Each CCU is represented by a node in the
6device tree.
7
8This binding uses the common clock binding:
9 Documentation/devicetree/bindings/clock/clock-bindings.txt
10
11Required properties:
12- compatible
13 Shall have a value of the form "brcm,<model>-<which>-ccu",
14 where <model> is a Broadcom SoC model number and <which> is
15 the name of a defined CCU. For example:
16 "brcm,bcm11351-root-ccu"
17 The compatible strings used for each supported SoC family
18 are defined below.
19- reg
20 Shall define the base and range of the address space
21 containing clock control registers
22- #clock-cells
23 Shall have value <1>. The permitted clock-specifier values
24 are defined below.
25- clock-output-names
26 Shall be an ordered list of strings defining the names of
27 the clocks provided by the CCU.
28
29Device tree example:
30
31 slave_ccu: slave_ccu {
32 compatible = "brcm,bcm11351-slave-ccu";
33 reg = <0x3e011000 0x0f00>;
34 #clock-cells = <1>;
35 clock-output-names = "uartb",
36 "uartb2",
37 "uartb3",
38 "uartb4";
39 };
40
41 ref_crystal_clk: ref_crystal {
42 #clock-cells = <0>;
43 compatible = "fixed-clock";
44 clock-frequency = <26000000>;
45 };
46
47 uart@3e002000 {
48 compatible = "brcm,bcm11351-dw-apb-uart", "snps,dw-apb-uart";
49 status = "disabled";
50 reg = <0x3e002000 0x1000>;
51 clocks = <&slave_ccu BCM281XX_SLAVE_CCU_UARTB3>;
52 interrupts = <GIC_SPI 65 IRQ_TYPE_LEVEL_HIGH>;
53 reg-shift = <2>;
54 reg-io-width = <4>;
55 };
56
57BCM281XX family
58---------------
59CCU compatible string values for SoCs in the BCM281XX family are:
60 "brcm,bcm11351-root-ccu"
61 "brcm,bcm11351-aon-ccu"
62 "brcm,bcm11351-hub-ccu"
63 "brcm,bcm11351-master-ccu"
64 "brcm,bcm11351-slave-ccu"
65
66The following table defines the set of CCUs and clock specifiers for
67BCM281XX family clocks. When a clock consumer references a clocks,
68its symbolic specifier (rather than its numeric index value) should
69be used. These specifiers are defined in:
70 "include/dt-bindings/clock/bcm281xx.h"
71
72 CCU Clock Type Index Specifier
73 --- ----- ---- ----- ---------
74 root frac_1m peri 0 BCM281XX_ROOT_CCU_FRAC_1M
75
76 aon hub_timer peri 0 BCM281XX_AON_CCU_HUB_TIMER
77 aon pmu_bsc peri 1 BCM281XX_AON_CCU_PMU_BSC
78 aon pmu_bsc_var peri 2 BCM281XX_AON_CCU_PMU_BSC_VAR
79
80 hub tmon_1m peri 0 BCM281XX_HUB_CCU_TMON_1M
81
82 master sdio1 peri 0 BCM281XX_MASTER_CCU_SDIO1
83 master sdio2 peri 1 BCM281XX_MASTER_CCU_SDIO2
84 master sdio3 peri 2 BCM281XX_MASTER_CCU_SDIO3
85 master sdio4 peri 3 BCM281XX_MASTER_CCU_SDIO4
86 master dmac peri 4 BCM281XX_MASTER_CCU_DMAC
87 master usb_ic peri 5 BCM281XX_MASTER_CCU_USB_IC
88 master hsic2_48m peri 6 BCM281XX_MASTER_CCU_HSIC_48M
89 master hsic2_12m peri 7 BCM281XX_MASTER_CCU_HSIC_12M
90
91 slave uartb peri 0 BCM281XX_SLAVE_CCU_UARTB
92 slave uartb2 peri 1 BCM281XX_SLAVE_CCU_UARTB2
93 slave uartb3 peri 2 BCM281XX_SLAVE_CCU_UARTB3
94 slave uartb4 peri 3 BCM281XX_SLAVE_CCU_UARTB4
95 slave ssp0 peri 4 BCM281XX_SLAVE_CCU_SSP0
96 slave ssp2 peri 5 BCM281XX_SLAVE_CCU_SSP2
97 slave bsc1 peri 6 BCM281XX_SLAVE_CCU_BSC1
98 slave bsc2 peri 7 BCM281XX_SLAVE_CCU_BSC2
99 slave bsc3 peri 8 BCM281XX_SLAVE_CCU_BSC3
100 slave pwm peri 9 BCM281XX_SLAVE_CCU_PWM
101
102
103BCM21664 family
104---------------
105CCU compatible string values for SoCs in the BCM21664 family are:
106 "brcm,bcm21664-root-ccu"
107 "brcm,bcm21664-aon-ccu"
108 "brcm,bcm21664-master-ccu"
109 "brcm,bcm21664-slave-ccu"
110
111The following table defines the set of CCUs and clock specifiers for
112BCM21664 family clocks. When a clock consumer references a clocks,
113its symbolic specifier (rather than its numeric index value) should
114be used. These specifiers are defined in:
115 "include/dt-bindings/clock/bcm21664.h"
116
117 CCU Clock Type Index Specifier
118 --- ----- ---- ----- ---------
119 root frac_1m peri 0 BCM21664_ROOT_CCU_FRAC_1M
120
121 aon hub_timer peri 0 BCM21664_AON_CCU_HUB_TIMER
122
123 master sdio1 peri 0 BCM21664_MASTER_CCU_SDIO1
124 master sdio2 peri 1 BCM21664_MASTER_CCU_SDIO2
125 master sdio3 peri 2 BCM21664_MASTER_CCU_SDIO3
126 master sdio4 peri 3 BCM21664_MASTER_CCU_SDIO4
127 master sdio1_sleep peri 4 BCM21664_MASTER_CCU_SDIO1_SLEEP
128 master sdio2_sleep peri 5 BCM21664_MASTER_CCU_SDIO2_SLEEP
129 master sdio3_sleep peri 6 BCM21664_MASTER_CCU_SDIO3_SLEEP
130 master sdio4_sleep peri 7 BCM21664_MASTER_CCU_SDIO4_SLEEP
131
132 slave uartb peri 0 BCM21664_SLAVE_CCU_UARTB
133 slave uartb2 peri 1 BCM21664_SLAVE_CCU_UARTB2
134 slave uartb3 peri 2 BCM21664_SLAVE_CCU_UARTB3
135 slave uartb4 peri 3 BCM21664_SLAVE_CCU_UARTB4
136 slave bsc1 peri 4 BCM21664_SLAVE_CCU_BSC1
137 slave bsc2 peri 5 BCM21664_SLAVE_CCU_BSC2
138 slave bsc3 peri 6 BCM21664_SLAVE_CCU_BSC3
139 slave bsc4 peri 7 BCM21664_SLAVE_CCU_BSC4
generated by cgit v1.2.2 (git 2.25.0) at 2026-01-20 23:24:17 -0500