watchdog: report options in sysfs
[linux-block.git] / Documentation / ABI / testing / sysfs-class-watchdog
CommitLineData
33b71126
PA
1What: /sys/class/watchdog/watchdogn/bootstatus
2Date: August 2015
3Contact: Wim Van Sebroeck <wim@iguana.be>
4Description:
5 It is a read only file. It contains status of the watchdog
6 device at boot. It is equivalent to WDIOC_GETBOOTSTATUS of
7 ioctl interface.
8
ad8bc199
TW
9What: /sys/class/watchdog/watchdogn/options
10Date: April 2023
11Contact: Thomas Weißschuh
12Description:
13 It is a read only file. It contains options of watchdog device.
14
b852e7a4
TW
15What: /sys/class/watchdog/watchdogn/fw_version
16Date: April 2023
17Contact: Thomas Weißschuh
18Description:
19 It is a read only file. It contains firmware version of
20 watchdog device.
21
33b71126
PA
22What: /sys/class/watchdog/watchdogn/identity
23Date: August 2015
24Contact: Wim Van Sebroeck <wim@iguana.be>
25Description:
26 It is a read only file. It contains identity string of
27 watchdog device.
28
29What: /sys/class/watchdog/watchdogn/nowayout
30Date: August 2015
31Contact: Wim Van Sebroeck <wim@iguana.be>
32Description:
bc44fa73
RV
33 It is a read/write file. While reading, it gives '1'
34 if the device has the nowayout feature set, otherwise
35 it gives '0'. Writing a '1' to the file enables the
36 nowayout feature. Once set, the nowayout feature
37 cannot be disabled, so writing a '0' either has no
38 effect (if the feature was already disabled) or
39 results in a permission error.
33b71126
PA
40
41What: /sys/class/watchdog/watchdogn/state
42Date: August 2015
43Contact: Wim Van Sebroeck <wim@iguana.be>
44Description:
45 It is a read only file. It gives active/inactive status of
46 watchdog device.
47
48What: /sys/class/watchdog/watchdogn/status
49Date: August 2015
50Contact: Wim Van Sebroeck <wim@iguana.be>
51Description:
52 It is a read only file. It contains watchdog device's
53 internal status bits. It is equivalent to WDIOC_GETSTATUS
54 of ioctl interface.
55
56What: /sys/class/watchdog/watchdogn/timeleft
57Date: August 2015
58Contact: Wim Van Sebroeck <wim@iguana.be>
59Description:
60 It is a read only file. It contains value of time left for
61 reset generation. It is equivalent to WDIOC_GETTIMELEFT of
62 ioctl interface.
63
64What: /sys/class/watchdog/watchdogn/timeout
65Date: August 2015
66Contact: Wim Van Sebroeck <wim@iguana.be>
67Description:
68 It is a read only file. It is read to know about current
69 value of timeout programmed.
d02d104e
JH
70
71What: /sys/class/watchdog/watchdogn/pretimeout
72Date: December 2016
73Contact: Wim Van Sebroeck <wim@iguana.be>
74Description:
75 It is a read only file. It specifies the time in seconds before
76 timeout when the pretimeout interrupt is delivered. Pretimeout
77 is an optional feature.
78
79What: /sys/class/watchdog/watchdogn/pretimeout_avaialable_governors
80Date: February 2017
81Contact: Wim Van Sebroeck <wim@iguana.be>
82Description:
83 It is a read only file. It shows the pretimeout governors
84 available for this watchdog.
85
86What: /sys/class/watchdog/watchdogn/pretimeout_governor
87Date: February 2017
88Contact: Wim Van Sebroeck <wim@iguana.be>
89Description:
90 It is a read/write file. When read, the currently assigned
91 pretimeout governor is returned. When written, it sets
92 the pretimeout governor.
ebdc0f58
IM
93
94What: /sys/class/watchdog/watchdog1/access_cs0
95Date: August 2019
96Contact: Ivan Mikhaylov <i.mikhaylov@yadro.com>,
97 Alexander Amelkin <a.amelkin@yadro.com>
98Description:
99 It is a read/write file. This attribute exists only if the
100 system has booted from the alternate flash chip due to
101 expiration of a watchdog timer of AST2400/AST2500 when
102 alternate boot function was enabled with 'aspeed,alt-boot'
103 devicetree option for that watchdog or with an appropriate
104 h/w strapping (for WDT2 only).
105
106 At alternate flash the 'access_cs0' sysfs node provides:
54a19b4d
MCC
107
108 ast2400:
109 a way to get access to the primary SPI flash
ebdc0f58
IM
110 chip at CS0 after booting from the alternate
111 chip at CS1.
54a19b4d
MCC
112 ast2500:
113 a way to restore the normal address mapping
ebdc0f58
IM
114 from (CS0->CS1, CS1->CS0) to (CS0->CS0,
115 CS1->CS1).
116
117 Clearing the boot code selection and timeout counter also
118 resets to the initial state the chip select line mapping. When
119 the SoC is in normal mapping state (i.e. booted from CS0),
120 clearing those bits does nothing for both versions of the SoC.
121 For alternate boot mode (booted from CS1 due to wdt2
122 expiration) the behavior differs as described above.
123
124 This option can be used with wdt2 (watchdog1) only.
125
126 When read, the current status of the boot code selection is
127 shown. When written with any non-zero value, it clears
128 the boot code selection and the timeout counter, which results
129 in chipselect reset for AST2400/AST2500.