Documentation/devicetree/bindings/reset/st,stih407-powerdown.yaml

Source file repositories/reference/linux-study-clean/Documentation/devicetree/bindings/reset/st,stih407-powerdown.yaml

File Facts

System
Linux kernel
Corpus path
Documentation/devicetree/bindings/reset/st,stih407-powerdown.yaml
Extension
.yaml
Size
1427 bytes
Lines
50
Domain
Support Tooling And Documentation
Bucket
Documentation
Inferred role
Support Tooling And Documentation: configuration, schema, or hardware description
Status
atlas-only

Why This File Exists

Repository support layer: documentation, build tooling, samples, user-space helper tools, generated initramfs support, licenses, and validation utilities.

Dependency Surface

Detected Declarations

Annotated Snippet

# 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>;
    };

Annotation

Implementation Notes