Merge branch 'fixes' of git://git.kernel.org/pub/scm/linux/kernel/git/evalenti/linux...
[linux/fpc-iii.git] / Documentation / devicetree / bindings / soc / fsl / rcpm.txt
blobe284e4e1ccd543c5d82ac96fd2d008a603401a23
1 * Run Control and Power Management
2 -------------------------------------------
3 The RCPM performs all device-level tasks associated with device run control
4 and power management.
6 Required properites:
7   - reg : Offset and length of the register set of the RCPM block.
8   - fsl,#rcpm-wakeup-cells : The number of IPPDEXPCR register cells in the
9         fsl,rcpm-wakeup property.
10   - compatible : Must contain a chip-specific RCPM block compatible string
11         and (if applicable) may contain a chassis-version RCPM compatible
12         string. Chip-specific strings are of the form "fsl,<chip>-rcpm",
13         such as:
14         * "fsl,p2041-rcpm"
15         * "fsl,p5020-rcpm"
16         * "fsl,t4240-rcpm"
18         Chassis-version strings are of the form "fsl,qoriq-rcpm-<version>",
19         such as:
20         * "fsl,qoriq-rcpm-1.0": for chassis 1.0 rcpm
21         * "fsl,qoriq-rcpm-2.0": for chassis 2.0 rcpm
22         * "fsl,qoriq-rcpm-2.1": for chassis 2.1 rcpm
24 All references to "1.0" and "2.0" refer to the QorIQ chassis version to
25 which the chip complies.
26 Chassis Version         Example Chips
27 ---------------         -------------------------------
28 1.0                             p4080, p5020, p5040, p2041, p3041
29 2.0                             t4240, b4860, b4420
30 2.1                             t1040, ls1021
32 Example:
33 The RCPM node for T4240:
34         rcpm: global-utilities@e2000 {
35                 compatible = "fsl,t4240-rcpm", "fsl,qoriq-rcpm-2.0";
36                 reg = <0xe2000 0x1000>;
37                 fsl,#rcpm-wakeup-cells = <2>;
38         };
40 * Freescale RCPM Wakeup Source Device Tree Bindings
41 -------------------------------------------
42 Required fsl,rcpm-wakeup property should be added to a device node if the device
43 can be used as a wakeup source.
45   - fsl,rcpm-wakeup: Consists of a phandle to the rcpm node and the IPPDEXPCR
46         register cells. The number of IPPDEXPCR register cells is defined in
47         "fsl,#rcpm-wakeup-cells" in the rcpm node. The first register cell is
48         the bit mask that should be set in IPPDEXPCR0, and the second register
49         cell is for IPPDEXPCR1, and so on.
51         Note: IPPDEXPCR(IP Powerdown Exception Control Register) provides a
52         mechanism for keeping certain blocks awake during STANDBY and MEM, in
53         order to use them as wake-up sources.
55 Example:
56         lpuart0: serial@2950000 {
57                 compatible = "fsl,ls1021a-lpuart";
58                 reg = <0x0 0x2950000 0x0 0x1000>;
59                 interrupts = <GIC_SPI 80 IRQ_TYPE_LEVEL_HIGH>;
60                 clocks = <&sysclk>;
61                 clock-names = "ipg";
62                 fsl,rcpm-wakeup = <&rcpm 0x0 0x40000000>;
63         };