xref: /linux/Documentation/ABI/stable/sysfs-driver-mlxreg-io (revision 95298d63c67673c654c08952672d016212b26054)
1What:		/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/asic_health
2Date:		June 2018
3KernelVersion:	4.19
4Contact:	Vadim Pasternak <vadimpmellanox.com>
5Description:	This file shows ASIC health status. The possible values are:
6		0 - health failed, 2 - health OK, 3 - ASIC in booting state.
7
8		The files are read only.
9
10What:		/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/cpld1_version
11What:		/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/cpld2_version
12Date:		June 2018
13KernelVersion:	4.19
14Contact:	Vadim Pasternak <vadimpmellanox.com>
15Description:	These files show with which CPLD versions have been burned
16		on carrier and switch boards.
17
18		The files are read only.
19
20What:		/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/fan_dir
21Date:		December 2018
22KernelVersion:	5.0
23Contact:	Vadim Pasternak <vadimpmellanox.com>
24Description:	This file shows the system fans direction:
25		forward direction - relevant bit is set 0;
26		reversed direction - relevant bit is set 1.
27
28		The files are read only.
29
30What:		/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/cpld3_version
31Date:		November 2018
32KernelVersion:	5.0
33Contact:	Vadim Pasternak <vadimpmellanox.com>
34Description:	These files show with which CPLD versions have been burned
35		on LED or Gearbox board.
36
37		The files are read only.
38
39What:		/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/jtag_enable
40Date:		November 2018
41KernelVersion:	5.0
42Contact:	Vadim Pasternak <vadimpmellanox.com>
43Description:	These files enable and disable the access to the JTAG domain.
44		By default access to the JTAG domain is disabled.
45
46		The file is read/write.
47
48What:		/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/select_iio
49Date:		June 2018
50KernelVersion:	4.19
51Contact:	Vadim Pasternak <vadimpmellanox.com>
52Description:	This file allows iio devices selection.
53
54		Attribute select_iio can be written with 0 or with 1. It
55		selects which one of iio devices can be accessed.
56
57		The file is read/write.
58
59What:		/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/psu1_on
60		/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/psu2_on
61		/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/pwr_cycle
62		/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/pwr_down
63Date:		June 2018
64KernelVersion:	4.19
65Contact:	Vadim Pasternak <vadimpmellanox.com>
66Description:	These files allow asserting system power cycling, switching
67		power supply units on and off and system's main power domain
68		shutdown.
69		Expected behavior:
70		When pwr_cycle is written 1: auxiliary power domain will go
71		down and after short period (about 1 second) up.
72		When  psu1_on or psu2_on is written 1, related unit will be
73		disconnected from the power source, when written 0 - connected.
74		If both are written 1 - power supplies main power domain will
75		go down.
76		When pwr_down is written 1, system's main power domain will go
77		down.
78
79		The files are write only.
80
81What:		/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/reset_aux_pwr_or_ref
82What:		/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/reset_asic_thermal
83What:		/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/reset_hotswap_or_halt
84What:		/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/reset_hotswap_or_wd
85What:		/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/reset_fw_reset
86What:		/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/reset_long_pb
87What:		/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/reset_main_pwr_fail
88What:		/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/reset_short_pb
89What:		/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/reset_sw_reset
90Date:		June 2018
91KernelVersion:	4.19
92Contact:	Vadim Pasternak <vadimpmellanox.com>
93Description:	These files show the system reset cause, as following: power
94		auxiliary outage or power refresh, ASIC thermal shutdown, halt,
95		hotswap, watchdog, firmware reset, long press power button,
96		short press power button, software reset. Value 1 in file means
97		this is reset cause, 0 - otherwise. Only one of the above
98		causes could be 1 at the same time, representing only last
99		reset cause.
100
101		The files are read only.
102
103What:		/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/reset_comex_pwr_fail
104What:		/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/reset_from_comex
105What:		/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/reset_system
106What:		/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/reset_voltmon_upgrade_fail
107Date:		November 2018
108KernelVersion:	5.0
109Contact:	Vadim Pasternak <vadimpmellanox.com>
110Description:	These files show the system reset cause, as following: ComEx
111		power fail, reset from ComEx, system platform reset, reset
112		due to voltage monitor devices upgrade failure,
113		Value 1 in file means this is reset cause, 0 - otherwise.
114		Only one bit could be 1 at the same time, representing only
115		the last reset cause.
116
117		The files are read only.
118
119What:		/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/cpld4_version
120Date:		November 2018
121KernelVersion:	5.0
122Contact:	Vadim Pasternak <vadimpmellanox.com>
123Description:	These files show with which CPLD versions have been burned
124		on LED board.
125
126		The files are read only.
127
128What:		/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/reset_comex_thermal
129What:		/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/reset_comex_wd
130What:		/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/reset_from_asic
131What:		/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/reset_reload_bios
132What:		/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/reset_sff_wd
133What:		/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/reset_swb_wd
134Date:		June 2019
135KernelVersion:	5.3
136Contact:	Vadim Pasternak <vadimpmellanox.com>
137Description:	These files show the system reset cause, as following:
138		COMEX thermal shutdown; wathchdog power off or reset was derived
139		by one of the next components: COMEX, switch board or by Small Form
140		Factor mezzanine, reset requested from ASIC, reset cuased by BIOS
141		reload. Value 1 in file means this is reset cause, 0 - otherwise.
142		Only one of the above causes could be 1 at the same time, representing
143		only last reset cause.
144
145		The files are read only.
146
147What:		/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/config1
148What:		/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/config2
149Date:		January 2020
150KernelVersion:	5.6
151Contact:	Vadim Pasternak <vadimpmellanox.com>
152Description:	These files show system static topology identification
153		like system's static I2C topology, number and type of FPGA
154		devices within the system and so on.
155
156		The files are read only.
157
158What:		/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/reset_ac_pwr_fail
159What:		/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/reset_platform
160What:		/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/reset_soc
161What:		/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/reset_sw_pwr_off
162Date:		January 2020
163KernelVersion:	5.6
164Contact:	Vadim Pasternak <vadimpmellanox.com>
165Description:	These files show the system reset causes, as following: reset
166		due to AC power failure, reset invoked from software by
167		assertion reset signal through CPLD. reset caused by signal
168		asserted by SOC through ACPI register, reset invoked from
169		software by assertion power off signal through CPLD.
170
171		The files are read only.
172
173What:		/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/pcie_asic_reset_dis
174Date:		January 2020
175KernelVersion:	5.6
176Contact:	Vadim Pasternak <vadimpmellanox.com>
177Description:	This file allows to retain ASIC up during PCIe root complex
178		reset, when attribute is set 1.
179
180		The file is read/write.
181
182What:		/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/vpd_wp
183Date:		January 2020
184KernelVersion:	5.6
185Contact:	Vadim Pasternak <vadimpmellanox.com>
186Description:	This file allows to overwrite system VPD hardware wrtie
187		protection when attribute is set 1.
188
189		The file is read/write.
190
191What:		/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/voltreg_update_status
192Date:		January 2020
193KernelVersion:	5.6
194Contact:	Vadim Pasternak <vadimpmellanox.com>
195Description:	This file exposes the configuration update status of burnable
196		voltage regulator devices. The status values are as following:
197		0 - OK; 1 - CRC failure; 2 = I2C failure; 3 - in progress.
198
199		The file is read only.
200
201What:		/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/ufm_version
202Date:		January 2020
203KernelVersion:	5.6
204Contact:	Vadim Pasternak <vadimpmellanox.com>
205Description:	This file exposes the firmware version of burnable voltage
206		regulator devices.
207
208		The file is read only.
209