xref: /linux/Documentation/devicetree/bindings/reset/st,stih407-powerdown.yaml (revision 4f2c0a4acffbec01079c28f839422e64ddeff004)
1*2ca065dcSPhilipp Zabel# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2*2ca065dcSPhilipp Zabel%YAML 1.2
3*2ca065dcSPhilipp Zabel---
4*2ca065dcSPhilipp Zabel$id: http://devicetree.org/schemas/reset/st,stih407-powerdown.yaml#
5*2ca065dcSPhilipp Zabel$schema: http://devicetree.org/meta-schemas/core.yaml#
6*2ca065dcSPhilipp Zabel
7*2ca065dcSPhilipp Zabeltitle: STMicroelectronics STi family Sysconfig Peripheral Powerdown Reset Controller
8*2ca065dcSPhilipp Zabel
9*2ca065dcSPhilipp Zabelmaintainers:
10*2ca065dcSPhilipp Zabel  - Srinivas Kandagatla <srinivas.kandagatla@st.com>
11*2ca065dcSPhilipp Zabel
12*2ca065dcSPhilipp Zabeldescription: |
13*2ca065dcSPhilipp Zabel  This binding describes a reset controller device that is used to enable and
14*2ca065dcSPhilipp Zabel  disable on-chip peripheral controllers such as USB and SATA, using
15*2ca065dcSPhilipp Zabel  "powerdown" control bits found in the STi family SoC system configuration
16*2ca065dcSPhilipp Zabel  registers. These have been grouped together into a single reset controller
17*2ca065dcSPhilipp Zabel  device for convenience.
18*2ca065dcSPhilipp Zabel
19*2ca065dcSPhilipp Zabel  The actual action taken when powerdown is asserted is hardware dependent.
20*2ca065dcSPhilipp Zabel  However, when asserted it may not be possible to access the hardware's
21*2ca065dcSPhilipp Zabel  registers and after an assert/deassert sequence the hardware's previous state
22*2ca065dcSPhilipp Zabel  may no longer be valid.
23*2ca065dcSPhilipp Zabel
24*2ca065dcSPhilipp Zabelproperties:
25*2ca065dcSPhilipp Zabel  compatible:
26*2ca065dcSPhilipp Zabel    const: st,stih407-powerdown
27*2ca065dcSPhilipp Zabel
28*2ca065dcSPhilipp Zabel  '#reset-cells':
29*2ca065dcSPhilipp Zabel    const: 1
30*2ca065dcSPhilipp Zabel
31*2ca065dcSPhilipp Zabelrequired:
32*2ca065dcSPhilipp Zabel  - compatible
33*2ca065dcSPhilipp Zabel  - '#reset-cells'
34*2ca065dcSPhilipp Zabel
35*2ca065dcSPhilipp ZabeladditionalProperties: false
36*2ca065dcSPhilipp Zabel
37*2ca065dcSPhilipp Zabelexamples:
38*2ca065dcSPhilipp Zabel  - |
39*2ca065dcSPhilipp Zabel    #include <dt-bindings/reset/stih407-resets.h>
40*2ca065dcSPhilipp Zabel
41*2ca065dcSPhilipp Zabel    powerdown: powerdown-controller {
42*2ca065dcSPhilipp Zabel        compatible = "st,stih407-powerdown";
43*2ca065dcSPhilipp Zabel        #reset-cells = <1>;
44*2ca065dcSPhilipp Zabel    };
45*2ca065dcSPhilipp Zabel
46*2ca065dcSPhilipp Zabel    // Specifying powerdown control of devices:
47*2ca065dcSPhilipp Zabel    st_dwc3: dwc3 {
48*2ca065dcSPhilipp Zabel        resets = <&powerdown STIH407_USB3_POWERDOWN>;
49*2ca065dcSPhilipp Zabel    };
50