1 # SPDX-License-Identifier: GPL-2.0 1 # SPDX-License-Identifier: GPL-2.0
2 %YAML 1.2 2 %YAML 1.2
3 --- 3 ---
4 $id: http://devicetree.org/schemas/mfd/syscon. 4 $id: http://devicetree.org/schemas/mfd/syscon.yaml#
5 $schema: http://devicetree.org/meta-schemas/co 5 $schema: http://devicetree.org/meta-schemas/core.yaml#
6 6
7 title: System Controller Devices !! 7 title: System Controller Registers R/W Device Tree Bindings
8 8
9 description: | 9 description: |
10 System controller node represents a register 10 System controller node represents a register region containing a set
11 of miscellaneous registers. The registers ar 11 of miscellaneous registers. The registers are not cohesive enough to
12 represent as any specific type of device. Th 12 represent as any specific type of device. The typical use-case is
13 for some other node's driver, or platform-sp 13 for some other node's driver, or platform-specific code, to acquire
14 a reference to the syscon node (e.g. by phan 14 a reference to the syscon node (e.g. by phandle, node path, or
15 search using a specific compatible value), i 15 search using a specific compatible value), interrogate the node (or
16 associated OS driver) to determine the locat 16 associated OS driver) to determine the location of the registers,
17 and access the registers directly. 17 and access the registers directly.
18 18
19 maintainers: 19 maintainers:
20 - Lee Jones <lee@kernel.org> !! 20 - Lee Jones <lee.jones@linaro.org>
21 21
22 # Need a select with all compatibles listed fo <<
23 # dtschema (<2024.02), so this will not be sel <<
24 # syscon fallback. <<
25 select: 22 select:
26 properties: 23 properties:
27 compatible: 24 compatible:
28 contains: 25 contains:
29 enum: 26 enum:
30 - al,alpine-sysfabric-servic !! 27 - syscon
31 - allwinner,sun8i-a83t-system-contro !! 28
32 - allwinner,sun8i-h3-system-controll <<
33 - allwinner,sun8i-v3s-system-control <<
34 - allwinner,sun50i-a64-system-contro <<
35 - altr,l3regs <<
36 - altr,sdr-ctl <<
37 - amd,pensando-elba-syscon <<
38 - amlogic,meson-mx-assist <<
39 - amlogic,meson-mx-bootrom <<
40 - amlogic,meson8-analog-top <<
41 - amlogic,meson8b-analog-top <<
42 - amlogic,meson8-pmu <<
43 - amlogic,meson8b-pmu <<
44 - apm,merlin-poweroff-mailbox <<
45 - apm,mustang-poweroff-mailbox <<
46 - apm,xgene-csw <<
47 - apm,xgene-efuse <<
48 - apm,xgene-mcb <<
49 - apm,xgene-rb <<
50 - apm,xgene-scu <<
51 - atmel,sama5d2-sfrbu <<
52 - atmel,sama5d3-nfc-io <<
53 - atmel,sama5d3-sfrbu <<
54 - atmel,sama5d4-sfrbu <<
55 - axis,artpec6-syscon <<
56 - brcm,cru-clkset <<
57 - brcm,sr-cdru <<
58 - brcm,sr-mhb <<
59 - cirrus,ep7209-syscon1 <<
60 - cirrus,ep7209-syscon2 <<
61 - cirrus,ep7209-syscon3 <<
62 - cnxt,cx92755-uc <<
63 - freecom,fsg-cs2-system-controller <<
64 - fsl,imx93-aonmix-ns-syscfg <<
65 - fsl,imx93-wakeupmix-syscfg <<
66 - fsl,ls1088a-reset <<
67 - fsl,vf610-anatop <<
68 - fsl,vf610-mscm-cpucfg <<
69 - hisilicon,dsa-subctrl <<
70 - hisilicon,hi6220-sramctrl <<
71 - hisilicon,hip04-ppe <<
72 - hisilicon,pcie-sas-subctrl <<
73 - hisilicon,peri-subctrl <<
74 - hpe,gxp-sysreg <<
75 - loongson,ls1b-syscon <<
76 - loongson,ls1c-syscon <<
77 - lsi,axxia-syscon <<
78 - marvell,armada-3700-cpu-misc <<
79 - marvell,armada-3700-nb-pm <<
80 - marvell,armada-3700-avs <<
81 - marvell,armada-3700-usb2-host-misc <<
82 - marvell,dove-global-config <<
83 - mediatek,mt2701-pctl-a-syscfg <<
84 - mediatek,mt2712-pctl-a-syscfg <<
85 - mediatek,mt6397-pctl-pmic-syscfg <<
86 - mediatek,mt8135-pctl-a-syscfg <<
87 - mediatek,mt8135-pctl-b-syscfg <<
88 - mediatek,mt8173-pctl-a-syscfg <<
89 - mediatek,mt8365-syscfg <<
90 - microchip,lan966x-cpu-syscon <<
91 - microchip,sam9x60-sfr <<
92 - microchip,sama7g5-ddr3phy <<
93 - mscc,ocelot-cpu-syscon <<
94 - mstar,msc313-pmsleep <<
95 - nuvoton,ma35d1-sys <<
96 - nuvoton,wpcm450-shm <<
97 - rockchip,px30-qos <<
98 - rockchip,rk3036-qos <<
99 - rockchip,rk3066-qos <<
100 - rockchip,rk3128-qos <<
101 - rockchip,rk3228-qos <<
102 - rockchip,rk3288-qos <<
103 - rockchip,rk3368-qos <<
104 - rockchip,rk3399-qos <<
105 - rockchip,rk3568-qos <<
106 - rockchip,rk3576-qos <<
107 - rockchip,rk3588-qos <<
108 - rockchip,rv1126-qos <<
109 - st,spear1340-misc <<
110 - stericsson,nomadik-pmu <<
111 - starfive,jh7100-sysmain <<
112 - ti,am62-opp-efuse-table <<
113 - ti,am62-usb-phy-ctrl <<
114 - ti,am625-dss-oldi-io-ctrl <<
115 - ti,am62p-cpsw-mac-efuse <<
116 - ti,am654-dss-oldi-io-ctrl <<
117 - ti,j784s4-acspcie-proxy-ctrl <<
118 - ti,j784s4-pcie-ctrl <<
119 - ti,keystone-pllctrl <<
120 required: 29 required:
121 - compatible 30 - compatible
122 31
123 properties: 32 properties:
124 compatible: 33 compatible:
125 items: !! 34 anyOf:
126 - enum: !! 35 - items:
127 - al,alpine-sysfabric-service !! 36 - enum:
128 - allwinner,sun8i-a83t-system-contro !! 37 - allwinner,sun8i-a83t-system-controller
129 - allwinner,sun8i-h3-system-controll !! 38 - allwinner,sun8i-h3-system-controller
130 - allwinner,sun8i-v3s-system-control !! 39 - allwinner,sun8i-v3s-system-controller
131 - allwinner,sun50i-a64-system-contro !! 40 - allwinner,sun50i-a64-system-controller
132 - altr,l3regs !! 41 - brcm,cru-clkset
133 - altr,sdr-ctl !! 42 - hisilicon,dsa-subctrl
134 - amd,pensando-elba-syscon !! 43 - hisilicon,hi6220-sramctrl
135 - amlogic,meson-mx-assist !! 44 - hisilicon,pcie-sas-subctrl
136 - amlogic,meson-mx-bootrom !! 45 - hisilicon,peri-subctrl
137 - amlogic,meson8-analog-top !! 46 - microchip,sparx5-cpu-syscon
138 - amlogic,meson8b-analog-top !! 47 - mstar,msc313-pmsleep
139 - amlogic,meson8-pmu !! 48 - rockchip,px30-qos
140 - amlogic,meson8b-pmu !! 49 - rockchip,rk3036-qos
141 - apm,merlin-poweroff-mailbox !! 50 - rockchip,rk3066-qos
142 - apm,mustang-poweroff-mailbox !! 51 - rockchip,rk3228-qos
143 - apm,xgene-csw !! 52 - rockchip,rk3288-qos
144 - apm,xgene-efuse !! 53 - rockchip,rk3368-qos
145 - apm,xgene-mcb !! 54 - rockchip,rk3399-qos
146 - apm,xgene-rb !! 55 - rockchip,rk3568-qos
147 - apm,xgene-scu !! 56 - samsung,exynos3-sysreg
148 - atmel,sama5d2-sfrbu !! 57 - samsung,exynos4-sysreg
149 - atmel,sama5d3-nfc-io !! 58 - samsung,exynos5-sysreg
150 - atmel,sama5d3-sfrbu !! 59 - samsung,exynos5433-sysreg
151 - atmel,sama5d4-sfrbu !! 60 - samsung,exynosautov9-sysreg
152 - axis,artpec6-syscon !! 61
153 - brcm,cru-clkset !! 62 - const: syscon
154 - brcm,sr-cdru !! 63
155 - brcm,sr-mhb !! 64 - contains:
156 - cirrus,ep7209-syscon1 !! 65 const: syscon
157 - cirrus,ep7209-syscon2 !! 66 minItems: 2
158 - cirrus,ep7209-syscon3 !! 67 maxItems: 4 # Should be enough
159 - cnxt,cx92755-uc <<
160 - freecom,fsg-cs2-system-controller <<
161 - fsl,imx93-aonmix-ns-syscfg <<
162 - fsl,imx93-wakeupmix-syscfg <<
163 - fsl,ls1088a-reset <<
164 - fsl,vf610-anatop <<
165 - fsl,vf610-mscm-cpucfg <<
166 - hisilicon,dsa-subctrl <<
167 - hisilicon,hi6220-sramctrl <<
168 - hisilicon,hip04-ppe <<
169 - hisilicon,pcie-sas-subctrl <<
170 - hisilicon,peri-subctrl <<
171 - hpe,gxp-sysreg <<
172 - loongson,ls1b-syscon <<
173 - loongson,ls1c-syscon <<
174 - lsi,axxia-syscon <<
175 - marvell,armada-3700-cpu-misc <<
176 - marvell,armada-3700-nb-pm <<
177 - marvell,armada-3700-avs <<
178 - marvell,armada-3700-usb2-host-misc <<
179 - marvell,dove-global-config <<
180 - mediatek,mt2701-pctl-a-syscfg <<
181 - mediatek,mt2712-pctl-a-syscfg <<
182 - mediatek,mt6397-pctl-pmic-syscfg <<
183 - mediatek,mt8135-pctl-a-syscfg <<
184 - mediatek,mt8135-pctl-b-syscfg <<
185 - mediatek,mt8173-pctl-a-syscfg <<
186 - mediatek,mt8365-syscfg <<
187 - microchip,lan966x-cpu-syscon <<
188 - microchip,sam9x60-sfr <<
189 - microchip,sama7g5-ddr3phy <<
190 - mscc,ocelot-cpu-syscon <<
191 - mstar,msc313-pmsleep <<
192 - nuvoton,ma35d1-sys <<
193 - nuvoton,wpcm450-shm <<
194 - rockchip,px30-qos <<
195 - rockchip,rk3036-qos <<
196 - rockchip,rk3066-qos <<
197 - rockchip,rk3128-qos <<
198 - rockchip,rk3228-qos <<
199 - rockchip,rk3288-qos <<
200 - rockchip,rk3368-qos <<
201 - rockchip,rk3399-qos <<
202 - rockchip,rk3568-qos <<
203 - rockchip,rk3576-qos <<
204 - rockchip,rk3588-qos <<
205 - rockchip,rv1126-qos <<
206 - st,spear1340-misc <<
207 - stericsson,nomadik-pmu <<
208 - starfive,jh7100-sysmain <<
209 - ti,am62-opp-efuse-table <<
210 - ti,am62-usb-phy-ctrl <<
211 - ti,am625-dss-oldi-io-ctrl <<
212 - ti,am62p-cpsw-mac-efuse <<
213 - ti,am654-dss-oldi-io-ctrl <<
214 - ti,j784s4-pcie-ctrl <<
215 - ti,keystone-pllctrl <<
216 - const: syscon <<
217 68
218 reg: 69 reg:
219 maxItems: 1 70 maxItems: 1
220 71
221 resets: !! 72 reg-io-width:
>> 73 description: |
>> 74 The size (in bytes) of the IO accesses that should be performed
>> 75 on the device.
>> 76 $ref: /schemas/types.yaml#/definitions/uint32
>> 77 enum: [1, 2, 4, 8]
>> 78
>> 79 hwlocks:
222 maxItems: 1 80 maxItems: 1
>> 81 description:
>> 82 Reference to a phandle of a hardware spinlock provider node.
223 83
224 required: 84 required:
225 - compatible 85 - compatible
226 - reg 86 - reg
227 87
228 allOf: !! 88 additionalProperties: true
229 - $ref: syscon-common.yaml# <<
230 <<
231 unevaluatedProperties: false <<
232 89
233 examples: 90 examples:
234 - | 91 - |
235 syscon: syscon@1c00000 { 92 syscon: syscon@1c00000 {
236 compatible = "allwinner,sun8i-h3-syste 93 compatible = "allwinner,sun8i-h3-system-controller", "syscon";
237 reg = <0x01c00000 0x1000>; 94 reg = <0x01c00000 0x1000>;
238 }; 95 };
>> 96
>> 97 - |
>> 98 gpr: iomuxc-gpr@20e0000 {
>> 99 compatible = "fsl,imx6q-iomuxc-gpr", "syscon";
>> 100 reg = <0x020e0000 0x38>;
>> 101 hwlocks = <&hwlock1 1>;
>> 102 };
>> 103
239 ... 104 ...
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.