0001 # SPDX-License-Identifier: GPL-2.0
0002 %YAML 1.2
0003 ---
0004 $id: http://devicetree.org/schemas/mfd/syscon.yaml#
0005 $schema: http://devicetree.org/meta-schemas/core.yaml#
0006
0007 title: System Controller Registers R/W Device Tree Bindings
0008
0009 description: |
0010 System controller node represents a register region containing a set
0011 of miscellaneous registers. The registers are not cohesive enough to
0012 represent as any specific type of device. The typical use-case is
0013 for some other node's driver, or platform-specific code, to acquire
0014 a reference to the syscon node (e.g. by phandle, node path, or
0015 search using a specific compatible value), interrogate the node (or
0016 associated OS driver) to determine the location of the registers,
0017 and access the registers directly.
0018
0019 maintainers:
0020 - Lee Jones <lee@kernel.org>
0021
0022 select:
0023 properties:
0024 compatible:
0025 contains:
0026 enum:
0027 - syscon
0028
0029 required:
0030 - compatible
0031
0032 properties:
0033 compatible:
0034 anyOf:
0035 - items:
0036 - enum:
0037 - allwinner,sun8i-a83t-system-controller
0038 - allwinner,sun8i-h3-system-controller
0039 - allwinner,sun8i-v3s-system-controller
0040 - allwinner,sun50i-a64-system-controller
0041 - brcm,cru-clkset
0042 - freecom,fsg-cs2-system-controller
0043 - hisilicon,dsa-subctrl
0044 - hisilicon,hi6220-sramctrl
0045 - hisilicon,pcie-sas-subctrl
0046 - hisilicon,peri-subctrl
0047 - intel,lgm-syscon
0048 - marvell,armada-3700-usb2-host-misc
0049 - mediatek,mt8135-pctl-a-syscfg
0050 - mediatek,mt8135-pctl-b-syscfg
0051 - microchip,lan966x-cpu-syscon
0052 - microchip,sparx5-cpu-syscon
0053 - mstar,msc313-pmsleep
0054 - rockchip,px30-qos
0055 - rockchip,rk3036-qos
0056 - rockchip,rk3066-qos
0057 - rockchip,rk3228-qos
0058 - rockchip,rk3288-qos
0059 - rockchip,rk3368-qos
0060 - rockchip,rk3399-qos
0061 - rockchip,rk3568-qos
0062 - samsung,exynos3-sysreg
0063 - samsung,exynos4-sysreg
0064 - samsung,exynos5-sysreg
0065 - samsung,exynos5433-sysreg
0066 - samsung,exynos850-sysreg
0067 - samsung,exynosautov9-sysreg
0068
0069 - const: syscon
0070
0071 - contains:
0072 const: syscon
0073 minItems: 2
0074 maxItems: 4 # Should be enough
0075
0076 reg:
0077 maxItems: 1
0078
0079 reg-io-width:
0080 description: |
0081 The size (in bytes) of the IO accesses that should be performed
0082 on the device.
0083 $ref: /schemas/types.yaml#/definitions/uint32
0084 enum: [1, 2, 4, 8]
0085
0086 hwlocks:
0087 maxItems: 1
0088 description:
0089 Reference to a phandle of a hardware spinlock provider node.
0090
0091 required:
0092 - compatible
0093 - reg
0094
0095 additionalProperties: true
0096
0097 examples:
0098 - |
0099 syscon: syscon@1c00000 {
0100 compatible = "allwinner,sun8i-h3-system-controller", "syscon";
0101 reg = <0x01c00000 0x1000>;
0102 };
0103 ...
