dt-bindings: reset: st,sti-powerdown: Convert to yaml
Convert the device tree bindings for the STMicroelectronics STi Peripheral Powerdown reset controller to YAML schema to allow participating in DT validation. Signed-off-by: Philipp Zabel <p.zabel@pengutronix.de> Cc: Srinivas Kandagatla <srinivas.kandagatla@st.com> Reviewed-by: Rob Herring <robh@kernel.org> Link: https://lore.kernel.org/r/20220407154338.4190674-13-p.zabel@pengutronix.de
This commit is contained in:
Родитель
b550b8a451
Коммит
2ca065dc94
|
@ -1,45 +0,0 @@
|
||||||
STMicroelectronics STi family Sysconfig Peripheral Powerdown Reset Controller
|
|
||||||
=============================================================================
|
|
||||||
|
|
||||||
This binding describes a reset controller device that is used to enable and
|
|
||||||
disable on-chip peripheral controllers such as USB and SATA, using
|
|
||||||
"powerdown" control bits found in the STi family SoC system configuration
|
|
||||||
registers. These have been grouped together into a single reset controller
|
|
||||||
device for convenience.
|
|
||||||
|
|
||||||
The actual action taken when powerdown is asserted is hardware dependent.
|
|
||||||
However, when asserted it may not be possible to access the hardware's
|
|
||||||
registers and after an assert/deassert sequence the hardware's previous state
|
|
||||||
may no longer be valid.
|
|
||||||
|
|
||||||
Please refer to reset.txt in this directory for common reset
|
|
||||||
controller binding usage.
|
|
||||||
|
|
||||||
Required properties:
|
|
||||||
- compatible: Should be "st,stih407-powerdown"
|
|
||||||
- #reset-cells: 1, see below
|
|
||||||
|
|
||||||
example:
|
|
||||||
|
|
||||||
powerdown: powerdown-controller {
|
|
||||||
compatible = "st,stih407-powerdown";
|
|
||||||
#reset-cells = <1>;
|
|
||||||
};
|
|
||||||
|
|
||||||
|
|
||||||
Specifying powerdown control of devices
|
|
||||||
=======================================
|
|
||||||
|
|
||||||
Device nodes should specify the reset channel required in their "resets"
|
|
||||||
property, containing a phandle to the powerdown device node and an
|
|
||||||
index specifying which channel to use, as described in reset.txt
|
|
||||||
|
|
||||||
example:
|
|
||||||
|
|
||||||
st_dwc3: dwc3@8f94000 {
|
|
||||||
resets = <&powerdown STIH407_USB3_POWERDOWN>,
|
|
||||||
};
|
|
||||||
|
|
||||||
Macro definitions for the supported reset channels can be found in:
|
|
||||||
|
|
||||||
include/dt-bindings/reset/stih407-resets.h
|
|
|
@ -0,0 +1,49 @@
|
||||||
|
# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
|
||||||
|
%YAML 1.2
|
||||||
|
---
|
||||||
|
$id: http://devicetree.org/schemas/reset/st,stih407-powerdown.yaml#
|
||||||
|
$schema: http://devicetree.org/meta-schemas/core.yaml#
|
||||||
|
|
||||||
|
title: STMicroelectronics STi family Sysconfig Peripheral Powerdown Reset Controller
|
||||||
|
|
||||||
|
maintainers:
|
||||||
|
- Srinivas Kandagatla <srinivas.kandagatla@st.com>
|
||||||
|
|
||||||
|
description: |
|
||||||
|
This binding describes a reset controller device that is used to enable and
|
||||||
|
disable on-chip peripheral controllers such as USB and SATA, using
|
||||||
|
"powerdown" control bits found in the STi family SoC system configuration
|
||||||
|
registers. These have been grouped together into a single reset controller
|
||||||
|
device for convenience.
|
||||||
|
|
||||||
|
The actual action taken when powerdown is asserted is hardware dependent.
|
||||||
|
However, when asserted it may not be possible to access the hardware's
|
||||||
|
registers and after an assert/deassert sequence the hardware's previous state
|
||||||
|
may no longer be valid.
|
||||||
|
|
||||||
|
properties:
|
||||||
|
compatible:
|
||||||
|
const: st,stih407-powerdown
|
||||||
|
|
||||||
|
'#reset-cells':
|
||||||
|
const: 1
|
||||||
|
|
||||||
|
required:
|
||||||
|
- compatible
|
||||||
|
- '#reset-cells'
|
||||||
|
|
||||||
|
additionalProperties: false
|
||||||
|
|
||||||
|
examples:
|
||||||
|
- |
|
||||||
|
#include <dt-bindings/reset/stih407-resets.h>
|
||||||
|
|
||||||
|
powerdown: powerdown-controller {
|
||||||
|
compatible = "st,stih407-powerdown";
|
||||||
|
#reset-cells = <1>;
|
||||||
|
};
|
||||||
|
|
||||||
|
// Specifying powerdown control of devices:
|
||||||
|
st_dwc3: dwc3 {
|
||||||
|
resets = <&powerdown STIH407_USB3_POWERDOWN>;
|
||||||
|
};
|
Загрузка…
Ссылка в новой задаче