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