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-powerdown.yaml#
5$schema: http://devicetree.org/meta-schemas/core.yaml#
6
7title: STMicroelectronics STi family Sysconfig Peripheral Powerdown Reset Controller
8
9maintainers:
10  - Srinivas Kandagatla <srinivas.kandagatla@st.com>
11
12description: |
13  This binding describes a reset controller device that is used to enable and
14  disable on-chip peripheral controllers such as USB and SATA, using
15  "powerdown" control bits found in the STi family SoC system configuration
16  registers. These have been grouped together into a single reset controller
17  device for convenience.
18
19  The actual action taken when powerdown is asserted is hardware dependent.
20  However, when asserted it may not be possible to access the hardware's
21  registers and after an assert/deassert sequence the hardware's previous state
22  may no longer be valid.
23
24properties:
25  compatible:
26    const: st,stih407-powerdown
27
28  '#reset-cells':
29    const: 1
30
31required:
32  - compatible
33  - '#reset-cells'
34
35additionalProperties: false
36
37examples:
38  - |
39    #include <dt-bindings/reset/stih407-resets.h>
40
41    powerdown: powerdown-controller {
42        compatible = "st,stih407-powerdown";
43        #reset-cells = <1>;
44    };
45
46    // Specifying powerdown control of devices:
47    st_dwc3: dwc3 {
48        resets = <&powerdown STIH407_USB3_POWERDOWN>;
49    };
50