xref: /freebsd/sys/contrib/device-tree/Bindings/spmi/spmi.txt (revision 5ca8e32633c4ffbbcd6762e5888b6a4ba0708c6c)
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