1fc58fcf6SSrinivas KandagatlaSTMicroelectronics STi family Sysconfig Peripheral SoftReset Controller
2fc58fcf6SSrinivas Kandagatla=============================================================================
3fc58fcf6SSrinivas Kandagatla
4fc58fcf6SSrinivas KandagatlaThis binding describes a reset controller device that is used to enable and
5fc58fcf6SSrinivas Kandagatladisable on-chip peripheral controllers such as USB and SATA, using
6fc58fcf6SSrinivas Kandagatla"softreset" control bits found in the STi family SoC system configuration
7fc58fcf6SSrinivas Kandagatlaregisters.
8fc58fcf6SSrinivas Kandagatla
9fc58fcf6SSrinivas KandagatlaThe actual action taken when softreset is asserted is hardware dependent.
10fc58fcf6SSrinivas KandagatlaHowever, when asserted it may not be possible to access the hardware's
11fc58fcf6SSrinivas Kandagatlaregisters and after an assert/deassert sequence the hardware's previous state
12fc58fcf6SSrinivas Kandagatlamay no longer be valid.
13fc58fcf6SSrinivas Kandagatla
14fc58fcf6SSrinivas KandagatlaPlease refer to reset.txt in this directory for common reset
15fc58fcf6SSrinivas Kandagatlacontroller binding usage.
16fc58fcf6SSrinivas Kandagatla
17fc58fcf6SSrinivas KandagatlaRequired properties:
18a47c9b39SJonathan Neuschäfer- compatible: Should be "st,stih407-softreset";
19fc58fcf6SSrinivas Kandagatla- #reset-cells: 1, see below
20fc58fcf6SSrinivas Kandagatla
21fc58fcf6SSrinivas Kandagatlaexample:
22fc58fcf6SSrinivas Kandagatla
23fc58fcf6SSrinivas Kandagatla	softreset: softreset-controller {
24fc58fcf6SSrinivas Kandagatla		#reset-cells = <1>;
254721ca73SPeter Griffin		compatible = "st,stih407-softreset";
26fc58fcf6SSrinivas Kandagatla	};
27fc58fcf6SSrinivas Kandagatla
28fc58fcf6SSrinivas Kandagatla
29fc58fcf6SSrinivas KandagatlaSpecifying softreset control of devices
30fc58fcf6SSrinivas Kandagatla=======================================
31fc58fcf6SSrinivas Kandagatla
32fc58fcf6SSrinivas KandagatlaDevice nodes should specify the reset channel required in their "resets"
33fc58fcf6SSrinivas Kandagatlaproperty, containing a phandle to the softreset device node and an
34fc58fcf6SSrinivas Kandagatlaindex specifying which channel to use, as described in reset.txt
35fc58fcf6SSrinivas Kandagatla
36fc58fcf6SSrinivas Kandagatlaexample:
37fc58fcf6SSrinivas Kandagatla
38fc58fcf6SSrinivas Kandagatla	ethernet0{
39fc58fcf6SSrinivas Kandagatla		resets			= <&softreset STIH415_ETH0_SOFTRESET>;
40fc58fcf6SSrinivas Kandagatla	};
41fc58fcf6SSrinivas Kandagatla
42fc58fcf6SSrinivas KandagatlaMacro definitions for the supported reset channels can be found in:
43fc58fcf6SSrinivas Kandagatla
444721ca73SPeter Griffininclude/dt-bindings/reset/stih407-resets.h
45