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/spmi/spmi.y 4 $id: http://devicetree.org/schemas/spmi/spmi.yaml#
5 $schema: http://devicetree.org/meta-schemas/co 5 $schema: http://devicetree.org/meta-schemas/core.yaml#
6 6
7 title: System Power Management Interface (SPMI 7 title: System Power Management Interface (SPMI) Controller
8 8
9 maintainers: 9 maintainers:
10 - Stephen Boyd <sboyd@kernel.org> 10 - Stephen Boyd <sboyd@kernel.org>
11 11
12 description: | 12 description: |
13 The System Power Management (SPMI) controlle 13 The System Power Management (SPMI) controller is a 2-wire bus defined
14 by the MIPI Alliance for power management co 14 by the MIPI Alliance for power management control to be used on SoC designs.
15 15
16 SPMI controllers are modelled in device tree 16 SPMI controllers are modelled in device tree using a generic set of
17 bindings defined here, plus any bus controll 17 bindings defined here, plus any bus controller specific properties, if
18 needed. 18 needed.
19 19
20 Each SPMI controller has zero or more child 20 Each SPMI controller has zero or more child nodes (up to 16 ones), each
21 one representing an unique slave at the bus. 21 one representing an unique slave at the bus.
22 22
23 properties: 23 properties:
24 $nodename: 24 $nodename:
25 pattern: "^spmi@.*" 25 pattern: "^spmi@.*"
26 26
27 "#address-cells": 27 "#address-cells":
28 const: 2 28 const: 2
29 29
30 "#size-cells": 30 "#size-cells":
31 const: 0 31 const: 0
32 32
33 patternProperties: 33 patternProperties:
34 "@[0-9a-f]$": 34 "@[0-9a-f]$":
35 description: up to 16 child PMIC nodes 35 description: up to 16 child PMIC nodes
36 type: object 36 type: object
37 37
38 properties: 38 properties:
39 reg: 39 reg:
40 items: 40 items:
41 - minItems: 1 41 - minItems: 1
42 items: 42 items:
43 - minimum: 0 43 - minimum: 0
44 maximum: 0xf 44 maximum: 0xf
45 - enum: [ 0 ] 45 - enum: [ 0 ]
46 description: 46 description:
47 0 means user ID address. 1 i 47 0 means user ID address. 1 is reserved for group ID
48 address. 48 address.
49 49
50 required: 50 required:
51 - reg 51 - reg
52 52
53 required: 53 required:
54 - reg 54 - reg
55 55
56 additionalProperties: true 56 additionalProperties: true
57 57
58 examples: 58 examples:
59 - | 59 - |
60 #include <dt-bindings/spmi/spmi.h> 60 #include <dt-bindings/spmi/spmi.h>
61 61
62 spmi@0 { 62 spmi@0 {
63 reg = <0 0>; 63 reg = <0 0>;
64 64
65 #address-cells = <2>; 65 #address-cells = <2>;
66 #size-cells = <0>; 66 #size-cells = <0>;
67 67
68 child@0 { 68 child@0 {
69 reg = <0 SPMI_USID>; 69 reg = <0 SPMI_USID>;
70 }; 70 };
71 71
72 child@7 { 72 child@7 {
73 reg = <7 SPMI_USID>; 73 reg = <7 SPMI_USID>;
74 }; 74 };
75 }; 75 };
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.