xref: /linux/Documentation/ABI/stable/sysfs-driver-mlxreg-io (revision 71e2f4dd5a65bd8dbca0b77661e75eea471168f8)
1What:		/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/asic_health
2
3Date:		June 2018
4KernelVersion:	4.19
5Contact:	Vadim Pasternak <vadimpmellanox.com>
6Description:	This file shows ASIC health status. The possible values are:
7		0 - health failed, 2 - health OK, 3 - ASIC in booting state.
8
9		The files are read only.
10
11What:		/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/cpld1_version
12What:		/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/cpld2_version
13Date:		June 2018
14KernelVersion:	4.19
15Contact:	Vadim Pasternak <vadimpmellanox.com>
16Description:	These files show with which CPLD versions have been burned
17		on carrier and switch boards.
18
19		The files are read only.
20
21What:		/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/fan_dir
22
23Date:		December 2018
24KernelVersion:	5.0
25Contact:	Vadim Pasternak <vadimpmellanox.com>
26Description:	This file shows the system fans direction:
27		forward direction - relevant bit is set 0;
28		reversed direction - relevant bit is set 1.
29
30		The files are read only.
31
32What:		/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/jtag_enable
33
34Date:		November 2018
35KernelVersion:	5.0
36Contact:	Vadim Pasternak <vadimpmellanox.com>
37Description:	These files show with which CPLD versions have been burned
38		on LED board.
39
40		The files are read only.
41
42What:		/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/jtag_enable
43
44Date:		November 2018
45KernelVersion:	5.0
46Contact:	Vadim Pasternak <vadimpmellanox.com>
47Description:	These files enable and disable the access to the JTAG domain.
48		By default access to the JTAG domain is disabled.
49
50		The file is read/write.
51
52What:		/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/select_iio
53Date:		June 2018
54KernelVersion:	4.19
55Contact:	Vadim Pasternak <vadimpmellanox.com>
56Description:	This file allows iio devices selection.
57
58		Attribute select_iio can be written with 0 or with 1. It
59		selects which one of iio devices can be accessed.
60
61		The file is read/write.
62
63What:		/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/psu1_on
64		/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/psu2_on
65		/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/pwr_cycle
66		/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/pwr_down
67Date:		June 2018
68KernelVersion:	4.19
69Contact:	Vadim Pasternak <vadimpmellanox.com>
70Description:	These files allow asserting system power cycling, switching
71		power supply units on and off and system's main power domain
72		shutdown.
73		Expected behavior:
74		When pwr_cycle is written 1: auxiliary power domain will go
75		down and after short period (about 1 second) up.
76		When  psu1_on or psu2_on is written 1, related unit will be
77		disconnected from the power source, when written 0 - connected.
78		If both are written 1 - power supplies main power domain will
79		go down.
80		When pwr_down is written 1, system's main power domain will go
81		down.
82
83		The files are write only.
84
85What:		/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/reset_aux_pwr_or_ref
86What:		/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/reset_asic_thermal
87What:		/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/reset_hotswap_or_halt
88What:		/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/reset_hotswap_or_wd
89What:		/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/reset_fw_reset
90What:		/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/reset_long_pb
91What:		/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/reset_main_pwr_fail
92What:		/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/reset_short_pb
93What:		/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/reset_sw_reset
94Date:		June 2018
95KernelVersion:	4.19
96Contact:	Vadim Pasternak <vadimpmellanox.com>
97Description:	These files show the system reset cause, as following: power
98		auxiliary outage or power refresh, ASIC thermal shutdown, halt,
99		hotswap, watchdog, firmware reset, long press power button,
100		short press power button, software reset. Value 1 in file means
101		this is reset cause, 0 - otherwise. Only one of the above
102		causes could be 1 at the same time, representing only last
103		reset cause.
104
105		The files are read only.
106
107What:		/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/reset_comex_pwr_fail
108What:		/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/reset_from_comex
109What:		/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/reset_system
110What:		/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/reset_voltmon_upgrade_fail
111
112Date:		November 2018
113KernelVersion:	5.0
114Contact:	Vadim Pasternak <vadimpmellanox.com>
115Description:	These files show the system reset cause, as following: ComEx
116		power fail, reset from ComEx, system platform reset, reset
117		due to voltage monitor devices upgrade failure,
118		Value 1 in file means this is reset cause, 0 - otherwise.
119		Only one bit could be 1 at the same time, representing only
120		the last reset cause.
121
122		The files are read only.
123
124Date:		June 2019
125KernelVersion:	5.3
126Contact:	Vadim Pasternak <vadimpmellanox.com>
127Description:	These files show the system reset cause, as following:
128		COMEX thermal shutdown; wathchdog power off or reset was derived
129		by one of the next components: COMEX, switch board or by Small Form
130		Factor mezzanine, reset requested from ASIC, reset cuased by BIOS
131		reload. Value 1 in file means this is reset cause, 0 - otherwise.
132		Only one of the above causes could be 1 at the same time, representing
133		only last reset cause.
134
135		The files are read only.
136
137What:		/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/reset_comex_thermal
138What:		/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/reset_comex_wd
139What:		/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/reset_from_asic
140What:		/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/reset_reload_bios
141What:		/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/reset_sff_wd
142What:		/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/reset_swb_wd
143