xref: /freebsd/sys/contrib/device-tree/Bindings/reset/st,stih407-picophyreset.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-picophyreset.yaml#
5*d5b0e70fSEmmanuel Vadot$schema: http://devicetree.org/meta-schemas/core.yaml#
6*d5b0e70fSEmmanuel Vadot
7*d5b0e70fSEmmanuel Vadottitle: STMicroelectronics STi family Sysconfig Picophy SoftReset Controller
8*d5b0e70fSEmmanuel Vadot
9*d5b0e70fSEmmanuel Vadotmaintainers:
10*d5b0e70fSEmmanuel Vadot  - Peter Griffin <peter.griffin@linaro.org>
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 PicoPHY USB2 phy(s) using "softreset" control bits found in
15*d5b0e70fSEmmanuel Vadot  the STi family SoC system configuration registers.
16*d5b0e70fSEmmanuel Vadot
17*d5b0e70fSEmmanuel Vadot  The actual action taken when softreset is asserted is hardware dependent.
18*d5b0e70fSEmmanuel Vadot  However, when asserted it may not be possible to access the hardware's
19*d5b0e70fSEmmanuel Vadot  registers and after an assert/deassert sequence the hardware's previous state
20*d5b0e70fSEmmanuel Vadot  may no longer be valid.
21*d5b0e70fSEmmanuel Vadot
22*d5b0e70fSEmmanuel Vadotproperties:
23*d5b0e70fSEmmanuel Vadot  compatible:
24*d5b0e70fSEmmanuel Vadot    const: st,stih407-picophyreset
25*d5b0e70fSEmmanuel Vadot
26*d5b0e70fSEmmanuel Vadot  '#reset-cells':
27*d5b0e70fSEmmanuel Vadot    const: 1
28*d5b0e70fSEmmanuel Vadot
29*d5b0e70fSEmmanuel Vadotrequired:
30*d5b0e70fSEmmanuel Vadot  - compatible
31*d5b0e70fSEmmanuel Vadot  - '#reset-cells'
32*d5b0e70fSEmmanuel Vadot
33*d5b0e70fSEmmanuel VadotadditionalProperties: false
34*d5b0e70fSEmmanuel Vadot
35*d5b0e70fSEmmanuel Vadotexamples:
36*d5b0e70fSEmmanuel Vadot  - |
37*d5b0e70fSEmmanuel Vadot    #include <dt-bindings/reset/stih407-resets.h>
38*d5b0e70fSEmmanuel Vadot
39*d5b0e70fSEmmanuel Vadot    picophyreset: picophyreset-controller {
40*d5b0e70fSEmmanuel Vadot        compatible = "st,stih407-picophyreset";
41*d5b0e70fSEmmanuel Vadot        #reset-cells = <1>;
42*d5b0e70fSEmmanuel Vadot    };
43*d5b0e70fSEmmanuel Vadot
44*d5b0e70fSEmmanuel Vadot    // Specifying picophyreset control of devices
45*d5b0e70fSEmmanuel Vadot    usb2_picophy0: usbpicophy {
46*d5b0e70fSEmmanuel Vadot        resets = <&picophyreset STIH407_PICOPHY0_RESET>;
47*d5b0e70fSEmmanuel Vadot    };
48