162306a36Sopenharmony_ciSTMicroelectronics STi family Sysconfig Peripheral SoftReset Controller 262306a36Sopenharmony_ci============================================================================= 362306a36Sopenharmony_ci 462306a36Sopenharmony_ciThis binding describes a reset controller device that is used to enable and 562306a36Sopenharmony_cidisable on-chip peripheral controllers such as USB and SATA, using 662306a36Sopenharmony_ci"softreset" control bits found in the STi family SoC system configuration 762306a36Sopenharmony_ciregisters. 862306a36Sopenharmony_ci 962306a36Sopenharmony_ciThe actual action taken when softreset is asserted is hardware dependent. 1062306a36Sopenharmony_ciHowever, when asserted it may not be possible to access the hardware's 1162306a36Sopenharmony_ciregisters and after an assert/deassert sequence the hardware's previous state 1262306a36Sopenharmony_cimay no longer be valid. 1362306a36Sopenharmony_ci 1462306a36Sopenharmony_ciPlease refer to reset.txt in this directory for common reset 1562306a36Sopenharmony_cicontroller binding usage. 1662306a36Sopenharmony_ci 1762306a36Sopenharmony_ciRequired properties: 1862306a36Sopenharmony_ci- compatible: Should be "st,stih407-softreset"; 1962306a36Sopenharmony_ci- #reset-cells: 1, see below 2062306a36Sopenharmony_ci 2162306a36Sopenharmony_ciexample: 2262306a36Sopenharmony_ci 2362306a36Sopenharmony_ci softreset: softreset-controller { 2462306a36Sopenharmony_ci #reset-cells = <1>; 2562306a36Sopenharmony_ci compatible = "st,stih407-softreset"; 2662306a36Sopenharmony_ci }; 2762306a36Sopenharmony_ci 2862306a36Sopenharmony_ci 2962306a36Sopenharmony_ciSpecifying softreset control of devices 3062306a36Sopenharmony_ci======================================= 3162306a36Sopenharmony_ci 3262306a36Sopenharmony_ciDevice nodes should specify the reset channel required in their "resets" 3362306a36Sopenharmony_ciproperty, containing a phandle to the softreset device node and an 3462306a36Sopenharmony_ciindex specifying which channel to use, as described in reset.txt 3562306a36Sopenharmony_ci 3662306a36Sopenharmony_ciexample: 3762306a36Sopenharmony_ci 3862306a36Sopenharmony_ci ethernet0{ 3962306a36Sopenharmony_ci resets = <&softreset STIH415_ETH0_SOFTRESET>; 4062306a36Sopenharmony_ci }; 4162306a36Sopenharmony_ci 4262306a36Sopenharmony_ciMacro definitions for the supported reset channels can be found in: 4362306a36Sopenharmony_ci 4462306a36Sopenharmony_ciinclude/dt-bindings/reset/stih407-resets.h 45