86e30dc371
This change adds SPMI Device Tree parsing. The of_spmi_register_devices() API should be called from the probe() routine of each SPMI controller to parse the subtree and add the respective SPMI devices. The SPMI subtree is nested up to two levels deep. The first level is the most basic and treats the address as the SPMI slave ID. This should be used for simple devices that has no notion of segmented SPMI address spaces. An optional second level specifies the address as an offset within the outer layer's slave ID. This is used to specify multiple devices on the same slave ID that have different address ranges. In fact, it's reasonable to specify any number of address ranges at this level. Devices can also specify any number of interrupts that's decoding is done by an external interrupt device. Sections of this code were taken from drivers/of/platform.c. Change-Id: Ib9f06764a9bd85e3b2aab43b72aa7132885aa044 Signed-off-by: Michael Bohan <mbohan@codeaurora.org>
73 lines
2.1 KiB
Plaintext
73 lines
2.1 KiB
Plaintext
* SPMI
|
|
|
|
The spmi Device Tree support interprets up to two levels of Device Tree
|
|
topology. The first level is required and specifies only a slave address.
|
|
The second level is optional and allows for the specification of different
|
|
offsets within the same 16-bit address space underneath a particular SPMI
|
|
slave ID. Within the second level, any number of address ranges can be
|
|
associated with a particular device within that 16-bit range.
|
|
|
|
First level
|
|
|
|
Required properites :
|
|
|
|
- reg: SPMI Slave ID (0-15) with no size cell.
|
|
- compatible : "qcom," prefixed string to match against the driver.
|
|
|
|
Recommended properties :
|
|
|
|
- interrupts : <a b c> where a is the slave ID, b is the peripheral ID,
|
|
c is the device interrupt number (0-7). Each device supports any arbitrary
|
|
number of interrupts.
|
|
- interrupt-parent : the phandle for the interrupt controller that
|
|
services interrupts for this device.
|
|
|
|
Second level
|
|
|
|
Required properties :
|
|
- spmi-dev-container: Used by the parser to understand that this is the second
|
|
level of the tree.
|
|
- reg: <a b> where a is < 65536 and b is a size. Each device supports an
|
|
arbitrary number of address ranges.
|
|
- compatible : "qcom," prefixed string to match against the driver.
|
|
|
|
Recommended properties :
|
|
|
|
- interrupts : <a b c> where a is the slave ID, b is is the peripheral ID,
|
|
c is the device interrupt number (0-7). Each device supports any arbitrary
|
|
number of interrupts.
|
|
- interrupt-parent : the phandle for the interrupt controller that
|
|
services interrupts for this device.
|
|
|
|
Example:
|
|
|
|
/ {
|
|
qcom,spmi@fc4c0000 {
|
|
#address-cells = <1>;
|
|
#size-cells = <0>;
|
|
interrupt-parent = <&qpnpint>;
|
|
pmic8941@d {
|
|
#address-cells = <1>;
|
|
#size-cells = <1>;
|
|
reg = <0xd>;
|
|
spmi-dev-container;
|
|
|
|
coincell@2800 {
|
|
compatible = "qcom,qpnp-coincell";
|
|
reg = <0x2800 0x4000>;
|
|
interrupts = <0xd 0x28 0x6 0xd 0x28 0x3>;
|
|
|
|
};
|
|
pon@800 {
|
|
compatible = "qcom,qpnp-pon";
|
|
reg = <0x800 0x4000>;
|
|
};
|
|
};
|
|
customer_dev@2 {
|
|
compatible = "qcom,qpnp-pon";
|
|
reg = <0x2>;
|
|
interrupts = <0x2 0x08 0x1 0x2 0x8 0x3>;
|
|
};
|
|
};
|
|
};
|