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-common.yaml#
5 $schema: http://devicetree.org/meta-schemas/co 5 $schema: http://devicetree.org/meta-schemas/core.yaml#
6 6
7 title: System Controller Registers R/W Common 7 title: System Controller Registers R/W Common Properties
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@kernel.org>
21 21
22 select: 22 select:
23 properties: 23 properties:
24 compatible: 24 compatible:
25 contains: 25 contains:
26 const: syscon 26 const: syscon
27 27
28 required: 28 required:
29 - compatible 29 - compatible
30 30
31 properties: 31 properties:
32 compatible: 32 compatible:
33 contains: 33 contains:
34 const: syscon 34 const: syscon
35 minItems: 2 35 minItems: 2
36 maxItems: 5 # Should be enough 36 maxItems: 5 # Should be enough
37 37
38 reg: 38 reg:
39 maxItems: 1 39 maxItems: 1
40 40
41 reg-io-width: 41 reg-io-width:
42 description: 42 description:
43 The size (in bytes) of the IO accesses t 43 The size (in bytes) of the IO accesses that should be performed
44 on the device. 44 on the device.
45 enum: [1, 2, 4, 8] 45 enum: [1, 2, 4, 8]
46 46
47 required: 47 required:
48 - compatible 48 - compatible
49 - reg 49 - reg
50 50
51 allOf: 51 allOf:
52 - if: 52 - if:
53 properties: 53 properties:
54 compatible: 54 compatible:
55 contains: 55 contains:
56 const: simple-mfd 56 const: simple-mfd
57 then: 57 then:
58 properties: 58 properties:
59 compatible: 59 compatible:
60 minItems: 3 60 minItems: 3
61 maxItems: 5 61 maxItems: 5
62 62
63 additionalProperties: true 63 additionalProperties: true
64 64
65 examples: 65 examples:
66 - | 66 - |
67 syscon: syscon@1c00000 { 67 syscon: syscon@1c00000 {
68 compatible = "allwinner,sun8i-h3-syste 68 compatible = "allwinner,sun8i-h3-system-controller", "syscon";
69 reg = <0x01c00000 0x1000>; 69 reg = <0x01c00000 0x1000>;
70 }; 70 };
71 ... 71 ...
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.