Documentation/devicetree/bindings/reset/st,stih407-powerdown.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-powerdown.yaml#
   5 $schema: http://devicetree.org/meta-schemas/core.yaml#
   6
   7 title: STMicroelectronics STi family Sysconfig Peripheral Powerdown Reset Controller
   8
   9 maintainers:
  10   - Srinivas Kandagatla <srinivas.kandagatla@st.com>
  11
  12 description: |
  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
  24 properties:
  25   compatible:
  26     const: st,stih407-powerdown
  27
  28   '#reset-cells':
  29     const: 1
  30
  31 required:
  32   - compatible
  33   - '#reset-cells'
  34
  35 additionalProperties: false
  36
  37 examples:
  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     };