diff options
| -rw-r--r-- | Documentation/devicetree/bindings/reset/img,pistachio-reset.txt | 55 |
1 files changed, 55 insertions, 0 deletions
diff --git a/Documentation/devicetree/bindings/reset/img,pistachio-reset.txt b/Documentation/devicetree/bindings/reset/img,pistachio-reset.txt new file mode 100644 index 000000000000..8c05d16367df --- /dev/null +++ b/Documentation/devicetree/bindings/reset/img,pistachio-reset.txt | |||
| @@ -0,0 +1,55 @@ | |||
| 1 | Pistachio Reset Controller | ||
| 2 | ============================================================================= | ||
| 3 | |||
| 4 | This binding describes a reset controller device that is used to enable and | ||
| 5 | disable individual IP blocks within the Pistachio SoC using "soft reset" | ||
| 6 | control bits found in the Pistachio SoC top level registers. | ||
| 7 | |||
| 8 | The actual action taken when soft reset is asserted is hardware dependent. | ||
| 9 | However, when asserted it may not be possible to access the hardware's | ||
| 10 | registers, and following an assert/deassert sequence the hardware's previous | ||
| 11 | state may no longer be valid. | ||
| 12 | |||
| 13 | Please refer to Documentation/devicetree/bindings/reset/reset.txt | ||
| 14 | for common reset controller binding usage. | ||
| 15 | |||
| 16 | Required properties: | ||
| 17 | |||
| 18 | - compatible: Contains "img,pistachio-reset" | ||
| 19 | |||
| 20 | - #reset-cells: Contains 1 | ||
| 21 | |||
| 22 | Example: | ||
| 23 | |||
| 24 | cr_periph: clk@18148000 { | ||
| 25 | compatible = "img,pistachio-cr-periph", "syscon", "simple-mfd"; | ||
| 26 | reg = <0x18148000 0x1000>; | ||
| 27 | clocks = <&clk_periph PERIPH_CLK_SYS>; | ||
| 28 | clock-names = "sys"; | ||
| 29 | #clock-cells = <1>; | ||
| 30 | |||
| 31 | pistachio_reset: reset-controller { | ||
| 32 | compatible = "img,pistachio-reset"; | ||
| 33 | #reset-cells = <1>; | ||
| 34 | }; | ||
| 35 | }; | ||
| 36 | |||
| 37 | Specifying reset control of devices | ||
| 38 | ======================================= | ||
| 39 | |||
| 40 | Device nodes should specify the reset channel required in their "resets" | ||
| 41 | property, containing a phandle to the pistachio reset device node and an | ||
| 42 | index specifying which reset to use, as described in | ||
| 43 | Documentation/devicetree/bindings/reset/reset.txt. | ||
| 44 | |||
| 45 | Example: | ||
| 46 | |||
| 47 | spdif_out: spdif-out@18100d00 { | ||
| 48 | ... | ||
| 49 | resets = <&pistachio_reset PISTACHIO_RESET_SPDIF_OUT>; | ||
| 50 | reset-names = "rst"; | ||
| 51 | ... | ||
| 52 | }; | ||
| 53 | |||
| 54 | Macro definitions for the supported resets can be found in: | ||
| 55 | include/dt-bindings/reset/pistachio-resets.h | ||
