1c66ec88fSEmmanuel Vadot# SPDX-License-Identifier: GPL-2.0 2c66ec88fSEmmanuel Vadot%YAML 1.2 3c66ec88fSEmmanuel Vadot--- 4c66ec88fSEmmanuel Vadot$id: http://devicetree.org/schemas/mfd/syscon.yaml# 5c66ec88fSEmmanuel Vadot$schema: http://devicetree.org/meta-schemas/core.yaml# 6c66ec88fSEmmanuel Vadot 77ef62cebSEmmanuel Vadottitle: System Controller Registers R/W 8c66ec88fSEmmanuel Vadot 9c66ec88fSEmmanuel Vadotdescription: | 10c66ec88fSEmmanuel Vadot System controller node represents a register region containing a set 11c66ec88fSEmmanuel Vadot of miscellaneous registers. The registers are not cohesive enough to 12c66ec88fSEmmanuel Vadot represent as any specific type of device. The typical use-case is 13c66ec88fSEmmanuel Vadot for some other node's driver, or platform-specific code, to acquire 14c66ec88fSEmmanuel Vadot a reference to the syscon node (e.g. by phandle, node path, or 15c66ec88fSEmmanuel Vadot search using a specific compatible value), interrogate the node (or 16c66ec88fSEmmanuel Vadot associated OS driver) to determine the location of the registers, 17c66ec88fSEmmanuel Vadot and access the registers directly. 18c66ec88fSEmmanuel Vadot 19c66ec88fSEmmanuel Vadotmaintainers: 20b97ee269SEmmanuel Vadot - Lee Jones <lee@kernel.org> 21c66ec88fSEmmanuel Vadot 22c66ec88fSEmmanuel Vadotselect: 23c66ec88fSEmmanuel Vadot properties: 24c66ec88fSEmmanuel Vadot compatible: 25c66ec88fSEmmanuel Vadot contains: 26c66ec88fSEmmanuel Vadot enum: 27c66ec88fSEmmanuel Vadot - syscon 28c66ec88fSEmmanuel Vadot 29c66ec88fSEmmanuel Vadot required: 30c66ec88fSEmmanuel Vadot - compatible 31c66ec88fSEmmanuel Vadot 32c66ec88fSEmmanuel Vadotproperties: 33c66ec88fSEmmanuel Vadot compatible: 34c66ec88fSEmmanuel Vadot anyOf: 35c66ec88fSEmmanuel Vadot - items: 36c66ec88fSEmmanuel Vadot - enum: 37c66ec88fSEmmanuel Vadot - allwinner,sun8i-a83t-system-controller 38c66ec88fSEmmanuel Vadot - allwinner,sun8i-h3-system-controller 39c66ec88fSEmmanuel Vadot - allwinner,sun8i-v3s-system-controller 40c66ec88fSEmmanuel Vadot - allwinner,sun50i-a64-system-controller 41cb7aa33aSEmmanuel Vadot - amd,pensando-elba-syscon 428cc087a1SEmmanuel Vadot - brcm,cru-clkset 43e67e8565SEmmanuel Vadot - freecom,fsg-cs2-system-controller 447ef62cebSEmmanuel Vadot - fsl,imx93-aonmix-ns-syscfg 457ef62cebSEmmanuel Vadot - fsl,imx93-wakeupmix-syscfg 466be33864SEmmanuel Vadot - hisilicon,dsa-subctrl 476be33864SEmmanuel Vadot - hisilicon,hi6220-sramctrl 486be33864SEmmanuel Vadot - hisilicon,pcie-sas-subctrl 496be33864SEmmanuel Vadot - hisilicon,peri-subctrl 50cb7aa33aSEmmanuel Vadot - hpe,gxp-sysreg 51c9ccf3a3SEmmanuel Vadot - intel,lgm-syscon 52*84943d6fSEmmanuel Vadot - loongson,ls1b-syscon 53*84943d6fSEmmanuel Vadot - loongson,ls1c-syscon 54c9ccf3a3SEmmanuel Vadot - marvell,armada-3700-usb2-host-misc 55c9ccf3a3SEmmanuel Vadot - mediatek,mt8135-pctl-a-syscfg 56c9ccf3a3SEmmanuel Vadot - mediatek,mt8135-pctl-b-syscfg 57cb7aa33aSEmmanuel Vadot - mediatek,mt8365-syscfg 58c9ccf3a3SEmmanuel Vadot - microchip,lan966x-cpu-syscon 59c66ec88fSEmmanuel Vadot - microchip,sparx5-cpu-syscon 60c66ec88fSEmmanuel Vadot - mstar,msc313-pmsleep 61fac71e4eSEmmanuel Vadot - nuvoton,ma35d1-sys 628bab661aSEmmanuel Vadot - nuvoton,wpcm450-shm 635def4c47SEmmanuel Vadot - rockchip,px30-qos 64354d7675SEmmanuel Vadot - rockchip,rk3036-qos 655def4c47SEmmanuel Vadot - rockchip,rk3066-qos 66*84943d6fSEmmanuel Vadot - rockchip,rk3128-qos 67354d7675SEmmanuel Vadot - rockchip,rk3228-qos 685def4c47SEmmanuel Vadot - rockchip,rk3288-qos 698cc087a1SEmmanuel Vadot - rockchip,rk3368-qos 705def4c47SEmmanuel Vadot - rockchip,rk3399-qos 71354d7675SEmmanuel Vadot - rockchip,rk3568-qos 727ef62cebSEmmanuel Vadot - rockchip,rk3588-qos 737ef62cebSEmmanuel Vadot - rockchip,rv1126-qos 74fac71e4eSEmmanuel Vadot - starfive,jh7100-sysmain 75*84943d6fSEmmanuel Vadot - ti,am654-dss-oldi-io-ctrl 76c66ec88fSEmmanuel Vadot 77c66ec88fSEmmanuel Vadot - const: syscon 78c66ec88fSEmmanuel Vadot 79c66ec88fSEmmanuel Vadot - contains: 80c66ec88fSEmmanuel Vadot const: syscon 81c66ec88fSEmmanuel Vadot minItems: 2 827ef62cebSEmmanuel Vadot maxItems: 5 # Should be enough 83c66ec88fSEmmanuel Vadot 84c66ec88fSEmmanuel Vadot reg: 85c66ec88fSEmmanuel Vadot maxItems: 1 86c66ec88fSEmmanuel Vadot 87c66ec88fSEmmanuel Vadot reg-io-width: 88c66ec88fSEmmanuel Vadot description: | 89c66ec88fSEmmanuel Vadot The size (in bytes) of the IO accesses that should be performed 90c66ec88fSEmmanuel Vadot on the device. 91c66ec88fSEmmanuel Vadot enum: [1, 2, 4, 8] 92c66ec88fSEmmanuel Vadot 93cb7aa33aSEmmanuel Vadot resets: 94cb7aa33aSEmmanuel Vadot maxItems: 1 95cb7aa33aSEmmanuel Vadot 96c66ec88fSEmmanuel Vadot hwlocks: 97c66ec88fSEmmanuel Vadot maxItems: 1 98c66ec88fSEmmanuel Vadot description: 99c66ec88fSEmmanuel Vadot Reference to a phandle of a hardware spinlock provider node. 100c66ec88fSEmmanuel Vadot 101c66ec88fSEmmanuel Vadotrequired: 102c66ec88fSEmmanuel Vadot - compatible 103c66ec88fSEmmanuel Vadot - reg 104c66ec88fSEmmanuel Vadot 1057ef62cebSEmmanuel VadotallOf: 1067ef62cebSEmmanuel Vadot - if: 1077ef62cebSEmmanuel Vadot properties: 1087ef62cebSEmmanuel Vadot compatible: 1097ef62cebSEmmanuel Vadot contains: 1107ef62cebSEmmanuel Vadot const: simple-mfd 1117ef62cebSEmmanuel Vadot then: 1127ef62cebSEmmanuel Vadot properties: 1137ef62cebSEmmanuel Vadot compatible: 1147ef62cebSEmmanuel Vadot minItems: 3 1157ef62cebSEmmanuel Vadot maxItems: 5 1167ef62cebSEmmanuel Vadot 1176be33864SEmmanuel VadotadditionalProperties: true 118c66ec88fSEmmanuel Vadot 119c66ec88fSEmmanuel Vadotexamples: 120c66ec88fSEmmanuel Vadot - | 121c66ec88fSEmmanuel Vadot syscon: syscon@1c00000 { 122c66ec88fSEmmanuel Vadot compatible = "allwinner,sun8i-h3-system-controller", "syscon"; 123c66ec88fSEmmanuel Vadot reg = <0x01c00000 0x1000>; 124c66ec88fSEmmanuel Vadot }; 125c66ec88fSEmmanuel Vadot... 126