1*4882a593SmuzhiyunSTMicroelectronics STi family Sysconfig Peripheral SoftReset Controller 2*4882a593Smuzhiyun============================================================================= 3*4882a593Smuzhiyun 4*4882a593SmuzhiyunThis binding describes a reset controller device that is used to enable and 5*4882a593Smuzhiyundisable on-chip peripheral controllers such as USB and SATA, using 6*4882a593Smuzhiyun"softreset" control bits found in the STi family SoC system configuration 7*4882a593Smuzhiyunregisters. 8*4882a593Smuzhiyun 9*4882a593SmuzhiyunThe actual action taken when softreset is asserted is hardware dependent. 10*4882a593SmuzhiyunHowever, when asserted it may not be possible to access the hardware's 11*4882a593Smuzhiyunregisters and after an assert/deassert sequence the hardware's previous state 12*4882a593Smuzhiyunmay no longer be valid. 13*4882a593Smuzhiyun 14*4882a593SmuzhiyunPlease refer to reset.txt in this directory for common reset 15*4882a593Smuzhiyuncontroller binding usage. 16*4882a593Smuzhiyun 17*4882a593SmuzhiyunRequired properties: 18*4882a593Smuzhiyun- compatible: Should be "st,stih407-softreset"; 19*4882a593Smuzhiyun- #reset-cells: 1, see below 20*4882a593Smuzhiyun 21*4882a593Smuzhiyunexample: 22*4882a593Smuzhiyun 23*4882a593Smuzhiyun softreset: softreset-controller { 24*4882a593Smuzhiyun #reset-cells = <1>; 25*4882a593Smuzhiyun compatible = "st,stih407-softreset"; 26*4882a593Smuzhiyun }; 27*4882a593Smuzhiyun 28*4882a593Smuzhiyun 29*4882a593SmuzhiyunSpecifying softreset control of devices 30*4882a593Smuzhiyun======================================= 31*4882a593Smuzhiyun 32*4882a593SmuzhiyunDevice nodes should specify the reset channel required in their "resets" 33*4882a593Smuzhiyunproperty, containing a phandle to the softreset device node and an 34*4882a593Smuzhiyunindex specifying which channel to use, as described in reset.txt 35*4882a593Smuzhiyun 36*4882a593Smuzhiyunexample: 37*4882a593Smuzhiyun 38*4882a593Smuzhiyun ethernet0{ 39*4882a593Smuzhiyun resets = <&softreset STIH415_ETH0_SOFTRESET>; 40*4882a593Smuzhiyun }; 41*4882a593Smuzhiyun 42*4882a593SmuzhiyunMacro definitions for the supported reset channels can be found in: 43*4882a593Smuzhiyun 44*4882a593Smuzhiyuninclude/dt-bindings/reset/stih407-resets.h 45