Linux kernel mirror (for testing)
git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel
os
linux
dt-bindings: soc: fsl: Convert rcpm to yaml format
Convert dt-binding rcpm from txt to yaml format.
Add fsl,ls1028a-rcpm compatible string.
Additional changes:
- Add missed compatible string fsl,<chip>-rcpm.
- Remove map fsl,<chip>-rcpm to fsl,qoriq-rcpm-<version>.
Signed-off-by: Frank Li <Frank.Li@nxp.com>
Link: https://lore.kernel.org/r/20240802152219.2740137-1-Frank.Li@nxp.com
Signed-off-by: Rob Herring (Arm) <robh@kernel.org>
authored by
Frank Li
and committed by
Rob Herring (Arm)
ad21e384
1c668ea6
+97
-70
+1
-1
Documentation/devicetree/bindings/rtc/fsl,ls-ftm-alarm.yaml
+1
-1
Documentation/devicetree/bindings/rtc/fsl,ls-ftm-alarm.yaml
+96
Documentation/devicetree/bindings/soc/fsl/fsl,rcpm.yaml
+96
Documentation/devicetree/bindings/soc/fsl/fsl,rcpm.yaml
···
1
+
# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2
+
%YAML 1.2
3
+
---
4
+
$id: http://devicetree.org/schemas/soc/fsl/fsl,rcpm.yaml#
5
+
$schema: http://devicetree.org/meta-schemas/core.yaml#
6
+
7
+
title: Run Control and Power Management
8
+
9
+
description:
10
+
The RCPM performs all device-level tasks associated with device run control
11
+
and power management.
12
+
13
+
maintainers:
14
+
- Frank Li <Frank.Li@nxp.com>
15
+
16
+
properties:
17
+
compatible:
18
+
oneOf:
19
+
- items:
20
+
- enum:
21
+
- fsl,p2041-rcpm
22
+
- fsl,p3041-rcpm
23
+
- fsl,p4080-rcpm
24
+
- fsl,p5020-rcpm
25
+
- fsl,p5040-rcpm
26
+
- const: fsl,qoriq-rcpm-1.0
27
+
- items:
28
+
- enum:
29
+
- fsl,b4420-rcpm
30
+
- fsl,b4860-rcpm
31
+
- fsl,t4240-rcpm
32
+
- const: fsl,qoriq-rcpm-2.0
33
+
- items:
34
+
- enum:
35
+
- fsl,t1040-rcpm
36
+
- const: fsl,qoriq-rcpm-2.1
37
+
- items:
38
+
- enum:
39
+
- fsl,ls1012a-rcpm
40
+
- fsl,ls1021a-rcpm
41
+
- fsl,ls1028a-rcpm
42
+
- fsl,ls1043a-rcpm
43
+
- fsl,ls1046a-rcpm
44
+
- fsl,ls1088a-rcpm
45
+
- fsl,ls208xa-rcpm
46
+
- fsl,lx2160a-rcpm
47
+
- const: fsl,qoriq-rcpm-2.1+
48
+
49
+
reg:
50
+
maxItems: 1
51
+
52
+
"#fsl,rcpm-wakeup-cells":
53
+
description: |
54
+
The number of IPPDEXPCR register cells in the
55
+
fsl,rcpm-wakeup property.
56
+
57
+
Freescale RCPM Wakeup Source Device Tree Bindings
58
+
59
+
Required fsl,rcpm-wakeup property should be added to a device node if
60
+
the device can be used as a wakeup source.
61
+
62
+
fsl,rcpm-wakeup: Consists of a phandle to the rcpm node and the IPPDEXPCR
63
+
register cells. The number of IPPDEXPCR register cells is defined in
64
+
"#fsl,rcpm-wakeup-cells" in the rcpm node. The first register cell is
65
+
the bit mask that should be set in IPPDEXPCR0, and the second register
66
+
cell is for IPPDEXPCR1, and so on.
67
+
68
+
Note: IPPDEXPCR(IP Powerdown Exception Control Register) provides a
69
+
mechanism for keeping certain blocks awake during STANDBY and MEM, in
70
+
order to use them as wake-up sources.
71
+
72
+
little-endian:
73
+
$ref: /schemas/types.yaml#/definitions/flag
74
+
description:
75
+
RCPM register block is Little Endian. Without it RCPM
76
+
will be Big Endian (default case).
77
+
78
+
additionalProperties: false
79
+
80
+
examples:
81
+
- |
82
+
#include <dt-bindings/interrupt-controller/arm-gic.h>
83
+
rcpm: global-utilities@e2000 {
84
+
compatible = "fsl,t4240-rcpm", "fsl,qoriq-rcpm-2.0";
85
+
reg = <0xe2000 0x1000>;
86
+
#fsl,rcpm-wakeup-cells = <2>;
87
+
};
88
+
89
+
serial@2950000 {
90
+
compatible = "fsl,ls1021a-lpuart";
91
+
reg = <0x2950000 0x1000>;
92
+
interrupts = <GIC_SPI 80 IRQ_TYPE_LEVEL_HIGH>;
93
+
clocks = <&sysclk>;
94
+
clock-names = "ipg";
95
+
fsl,rcpm-wakeup = <&rcpm 0x0 0x40000000>;
96
+
};
-69
Documentation/devicetree/bindings/soc/fsl/rcpm.txt
-69
Documentation/devicetree/bindings/soc/fsl/rcpm.txt
···
1
-
* Run Control and Power Management
2
-
-------------------------------------------
3
-
The RCPM performs all device-level tasks associated with device run control
4
-
and power management.
5
-
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"
17
-
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
23
-
* "fsl,qoriq-rcpm-2.1+": for chassis 2.1+ rcpm
24
-
25
-
All references to "1.0" and "2.0" refer to the QorIQ chassis version to
26
-
which the chip complies.
27
-
Chassis Version Example Chips
28
-
--------------- -------------------------------
29
-
1.0 p4080, p5020, p5040, p2041, p3041
30
-
2.0 t4240, b4860, b4420
31
-
2.1 t1040,
32
-
2.1+ ls1021a, ls1012a, ls1043a, ls1046a
33
-
34
-
Optional properties:
35
-
- little-endian : RCPM register block is Little Endian. Without it RCPM
36
-
will be Big Endian (default case).
37
-
38
-
Example:
39
-
The RCPM node for T4240:
40
-
rcpm: global-utilities@e2000 {
41
-
compatible = "fsl,t4240-rcpm", "fsl,qoriq-rcpm-2.0";
42
-
reg = <0xe2000 0x1000>;
43
-
#fsl,rcpm-wakeup-cells = <2>;
44
-
};
45
-
46
-
* Freescale RCPM Wakeup Source Device Tree Bindings
47
-
-------------------------------------------
48
-
Required fsl,rcpm-wakeup property should be added to a device node if the device
49
-
can be used as a wakeup source.
50
-
51
-
- fsl,rcpm-wakeup: Consists of a phandle to the rcpm node and the IPPDEXPCR
52
-
register cells. The number of IPPDEXPCR register cells is defined in
53
-
"#fsl,rcpm-wakeup-cells" in the rcpm node. The first register cell is
54
-
the bit mask that should be set in IPPDEXPCR0, and the second register
55
-
cell is for IPPDEXPCR1, and so on.
56
-
57
-
Note: IPPDEXPCR(IP Powerdown Exception Control Register) provides a
58
-
mechanism for keeping certain blocks awake during STANDBY and MEM, in
59
-
order to use them as wake-up sources.
60
-
61
-
Example:
62
-
lpuart0: serial@2950000 {
63
-
compatible = "fsl,ls1021a-lpuart";
64
-
reg = <0x0 0x2950000 0x0 0x1000>;
65
-
interrupts = <GIC_SPI 80 IRQ_TYPE_LEVEL_HIGH>;
66
-
clocks = <&sysclk>;
67
-
clock-names = "ipg";
68
-
fsl,rcpm-wakeup = <&rcpm 0x0 0x40000000>;
69
-
};