tjh.dev
Linux kernel mirror (for testing)
git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel
os
linux
dt-bindings: reset: st,sti-picophyreset: Convert to yaml
Convert the device tree bindings for the STMicroelectronics STi
SoftReset controller to YAML schema to allow participating in DT
validation.
Signed-off-by: Philipp Zabel <p.zabel@pengutronix.de>
Cc: Peter Griffin <peter.griffin@linaro.org>
Reviewed-by: Rob Herring <robh@kernel.org>
Link: https://lore.kernel.org/r/20220407154338.4190674-12-p.zabel@pengutronix.de
+47
-42
-42
Documentation/devicetree/bindings/reset/st,sti-picophyreset.txt
-42
Documentation/devicetree/bindings/reset/st,sti-picophyreset.txt
···
1
-
STMicroelectronics STi family Sysconfig Picophy SoftReset Controller
2
-
=============================================================================
3
-
4
-
This binding describes a reset controller device that is used to enable and
5
-
disable on-chip PicoPHY USB2 phy(s) using "softreset" control bits found in
6
-
the STi family SoC system configuration registers.
7
-
8
-
The actual action taken when softreset is asserted is hardware dependent.
9
-
However, when asserted it may not be possible to access the hardware's
10
-
registers and after an assert/deassert sequence the hardware's previous state
11
-
may no longer be valid.
12
-
13
-
Please refer to Documentation/devicetree/bindings/reset/reset.txt
14
-
for common reset controller binding usage.
15
-
16
-
Required properties:
17
-
- compatible: Should be "st,stih407-picophyreset"
18
-
- #reset-cells: 1, see below
19
-
20
-
Example:
21
-
22
-
picophyreset: picophyreset-controller {
23
-
compatible = "st,stih407-picophyreset";
24
-
#reset-cells = <1>;
25
-
};
26
-
27
-
Specifying picophyreset control of devices
28
-
=======================================
29
-
30
-
Device nodes should specify the reset channel required in their "resets"
31
-
property, containing a phandle to the picophyreset device node and an
32
-
index specifying which channel to use, as described in
33
-
Documentation/devicetree/bindings/reset/reset.txt.
34
-
35
-
Example:
36
-
37
-
usb2_picophy0: usbpicophy@0 {
38
-
resets = <&picophyreset STIH407_PICOPHY0_RESET>;
39
-
};
40
-
41
-
Macro definitions for the supported reset channels can be found in:
42
-
include/dt-bindings/reset/stih407-resets.h
+47
Documentation/devicetree/bindings/reset/st,stih407-picophyreset.yaml
+47
Documentation/devicetree/bindings/reset/st,stih407-picophyreset.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/st,stih407-picophyreset.yaml#
5
+
$schema: http://devicetree.org/meta-schemas/core.yaml#
6
+
7
+
title: STMicroelectronics STi family Sysconfig Picophy SoftReset Controller
8
+
9
+
maintainers:
10
+
- Peter Griffin <peter.griffin@linaro.org>
11
+
12
+
description: |
13
+
This binding describes a reset controller device that is used to enable and
14
+
disable on-chip PicoPHY USB2 phy(s) using "softreset" control bits found in
15
+
the STi family SoC system configuration registers.
16
+
17
+
The actual action taken when softreset is asserted is hardware dependent.
18
+
However, when asserted it may not be possible to access the hardware's
19
+
registers and after an assert/deassert sequence the hardware's previous state
20
+
may no longer be valid.
21
+
22
+
properties:
23
+
compatible:
24
+
const: st,stih407-picophyreset
25
+
26
+
'#reset-cells':
27
+
const: 1
28
+
29
+
required:
30
+
- compatible
31
+
- '#reset-cells'
32
+
33
+
additionalProperties: false
34
+
35
+
examples:
36
+
- |
37
+
#include <dt-bindings/reset/stih407-resets.h>
38
+
39
+
picophyreset: picophyreset-controller {
40
+
compatible = "st,stih407-picophyreset";
41
+
#reset-cells = <1>;
42
+
};
43
+
44
+
// Specifying picophyreset control of devices
45
+
usb2_picophy0: usbpicophy {
46
+
resets = <&picophyreset STIH407_PICOPHY0_RESET>;
47
+
};