Linux kernel mirror (for testing)
git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel
os
linux
dt-bindings: reset: Convert ti,sci-reset to json schema
Convert the ti,sci-reset to json schema for better checks and documentation.
Differences being:
- Drop consumer example as they are documented in the corresponding
bindings themselves.
- Drop phandle description for reset consumer or cell definition as it is
redundant.
Signed-off-by: Nishanth Menon <nm@ti.com>
Reviewed-by: Rob Herring <robh@kernel.org>
Reviewed-by: Tero Kristo <kristo@kernel.org>
Acked-by: Stephen Boyd <sboyd@kernel.org>
Link: https://lore.kernel.org/r/20210426155457.21221-2-nm@ti.com
Signed-off-by: Rob Herring <robh@kernel.org>
authored by
Nishanth Menon
and committed by
Rob Herring
9a81b8cb
6efb943b
+51
-62
-62
Documentation/devicetree/bindings/reset/ti,sci-reset.txt
-62
Documentation/devicetree/bindings/reset/ti,sci-reset.txt
···
1
-
Texas Instruments System Control Interface (TI-SCI) Reset Controller
2
-
=====================================================================
3
-
4
-
Some TI SoCs contain a system controller (like the Power Management Micro
5
-
Controller (PMMC) on Keystone 66AK2G SoC) that are responsible for controlling
6
-
the state of the various hardware modules present on the SoC. Communication
7
-
between the host processor running an OS and the system controller happens
8
-
through a protocol called TI System Control Interface (TI-SCI protocol).
9
-
For TI SCI details, please refer to the document,
10
-
Documentation/devicetree/bindings/arm/keystone/ti,sci.txt
11
-
12
-
TI-SCI Reset Controller Node
13
-
============================
14
-
This reset controller node uses the TI SCI protocol to perform the reset
15
-
management of various hardware modules present on the SoC. Must be a child
16
-
node of the associated TI-SCI system controller node.
17
-
18
-
Required properties:
19
-
--------------------
20
-
- compatible : Should be "ti,sci-reset"
21
-
- #reset-cells : Should be 2. Please see the reset consumer node below for
22
-
usage details.
23
-
24
-
TI-SCI Reset Consumer Nodes
25
-
===========================
26
-
Each of the reset consumer nodes should have the following properties,
27
-
in addition to their own properties.
28
-
29
-
Required properties:
30
-
--------------------
31
-
- resets : A phandle and reset specifier pair, one pair for each reset
32
-
signal that affects the device, or that the device manages.
33
-
The phandle should point to the TI-SCI reset controller node,
34
-
and the reset specifier should have 2 cell-values. The first
35
-
cell should contain the device ID. The second cell should
36
-
contain the reset mask value used by system controller.
37
-
Please refer to the protocol documentation for these values
38
-
to be used for different devices,
39
-
http://processors.wiki.ti.com/index.php/TISCI#66AK2G02_Data
40
-
41
-
Please also refer to Documentation/devicetree/bindings/reset/reset.txt for
42
-
common reset controller usage by consumers.
43
-
44
-
Example:
45
-
--------
46
-
The following example demonstrates both a TI-SCI reset controller node and a
47
-
consumer (a DSP device) on the 66AK2G SoC.
48
-
49
-
pmmc: pmmc {
50
-
compatible = "ti,k2g-sci";
51
-
52
-
k2g_reset: reset-controller {
53
-
compatible = "ti,sci-reset";
54
-
#reset-cells = <2>;
55
-
};
56
-
};
57
-
58
-
dsp0: dsp@10800000 {
59
-
...
60
-
resets = <&k2g_reset 0x0046 0x1>;
61
-
...
62
-
};
+51
Documentation/devicetree/bindings/reset/ti,sci-reset.yaml
+51
Documentation/devicetree/bindings/reset/ti,sci-reset.yaml
···
1
+
# SPDX-License-Identifier: (GPL-2.0-only or BSD-2-Clause)
2
+
%YAML 1.2
3
+
---
4
+
$id: http://devicetree.org/schemas/reset/ti,sci-reset.yaml#
5
+
$schema: http://devicetree.org/meta-schemas/core.yaml#
6
+
7
+
title: TI-SCI reset controller node bindings
8
+
9
+
maintainers:
10
+
- Nishanth Menon <nm@ti.com>
11
+
12
+
description: |
13
+
Some TI SoCs contain a system controller (like the Power Management Micro
14
+
Controller (PMMC) on Keystone 66AK2G SoC) that are responsible for controlling
15
+
the state of the various hardware modules present on the SoC. Communication
16
+
between the host processor running an OS and the system controller happens
17
+
through a protocol called TI System Control Interface (TI-SCI protocol).
18
+
19
+
This reset controller node uses the TI SCI protocol to perform the reset
20
+
management of various hardware modules present on the SoC. Must be a child
21
+
node of the associated TI-SCI system controller node.
22
+
23
+
properties:
24
+
$nodename:
25
+
pattern: "^reset-controller$"
26
+
27
+
compatible:
28
+
const: ti,sci-reset
29
+
30
+
"#reset-cells":
31
+
const: 2
32
+
description:
33
+
The two cells represent values that the TI-SCI controller defines.
34
+
35
+
The first cell should contain the device ID.
36
+
37
+
The second cell should contain the reset mask corresponding to the device
38
+
used by system controller.
39
+
40
+
Please see http://processors.wiki.ti.com/index.php/TISCI for
41
+
protocol documentation for the values to be used for different devices.
42
+
43
+
44
+
additionalProperties: false
45
+
46
+
examples:
47
+
- |
48
+
k3_reset: reset-controller {
49
+
compatible = "ti,sci-reset";
50
+
#reset-cells = <2>;
51
+
};