xref: /freebsd/sys/contrib/device-tree/Bindings/spmi/spmi.txt (revision cfd6422a5217410fbd66f7a7a8a64d9d85e61229)
1System Power Management Interface (SPMI) Controller
2
3This document defines a generic set of bindings for use by SPMI controllers.  A
4controller is modelled in device tree as a node with zero or more child nodes,
5each representing a unique slave on the bus.
6
7Required properties:
8- #address-cells : must be set to 2
9- #size-cells : must be set to 0
10
11Child nodes:
12
13An SPMI controller node can contain zero or more child nodes representing slave
14devices on the bus.  Child 'reg' properties are specified as an address, type
15pair.  The address must be in the range 0-15 (4 bits).  The type must be one of
16SPMI_USID (0) or SPMI_GSID (1) for Unique Slave ID or Group Slave ID respectively.
17These are the identifiers "statically assigned by the system integrator", as
18per the SPMI spec.
19
20Each child node must have one and only one 'reg' entry of type SPMI_USID.
21
22#include <dt-bindings/spmi/spmi.h>
23
24	spmi@.. {
25		compatible = "...";
26		reg = <...>;
27
28		#address-cells = <2>;
29		#size-cells = <0>;
30
31		child@0 {
32			compatible = "...";
33			reg = <0 SPMI_USID>;
34		};
35
36		child@7 {
37			compatible = "...";
38			reg = <7 SPMI_USID
39			       3 SPMI_GSID>;
40		};
41	};
42