]> rtime.felk.cvut.cz Git - hercules2020/nv-tegra/linux-4.4.git/blob - Documentation/devicetree/bindings/watchdog/tegra-wdt.txt
dt-binding: tegra: add timer source documentation
[hercules2020/nv-tegra/linux-4.4.git] / Documentation / devicetree / bindings / watchdog / tegra-wdt.txt
1 * NVIDIA Tegra Watchdog controller
2
3 Required properties:
4
5 - compatible: Should be "nvidia,tegra-wdt"
6 - reg: Should contain WDT and corresponding timer source
7   registers location and length.
8
9 Optional properties:
10
11 - interrupts: interrupt number to the cpu
12 - nvidia,expiry-count: total expiry count of WDT (1 if not specified)
13 - nvidia,enable-on-init: Toggle switch for enable during init
14 - nvidia,heartbeat-init: default timeout in secs (120 secs if not specified)
15 - nvidia,timer-index: timer source index for WDT
16
17 Timer source index:
18
19       There are three ways by which WDT timer source index can be specified
20 and timer source selection happens with below given priorty order (decending)
21 (a) Bootloader programs WDT and timer source
22 (b) "nvidia,timer-index" property in DT
23 (c) Timer source base address in DT (old method)
24
25 Method (a) is of highest priority, because bootloader can program the WDT timer
26 source and lock to prevent any further modification of timer source by kernel.
27 In order to calculate the timer source address in runtime in this case timer
28 base address is required and hence Timer base address should be provided in
29 timer resource property in DT.
30
31 Either timer base address or timer source address is expected in timer resource
32 property in DT for case (b).
33
34 Note: If method (c) is used it should correspond to the timer source index provided
35 in method (a) or (b) or make sure that method (a) or (b) is not in use.
36
37 Examples:
38
39 watchdog@60005100 {
40         compatible = "nvidia,tegra-wdt";
41         reg = <0x0 0x60005100 0x0 0x20          /* WDT0 registers */
42                 0x0 0x60005088 0x0 0x8>;        /* TMR0 registers */
43         interrupts = <0 123 0x04>;
44         nvidia,expiry-count = <4>;
45         nvidia,timer-index = <7>;
46         status = "disabled";
47 };