0001 What: /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/asic_health
0002 Date: June 2018
0003 KernelVersion: 4.19
0004 Contact: Vadim Pasternak <vadimp@nvidia.com>
0005 Description: This file shows ASIC health status. The possible values are:
0006 0 - health failed, 2 - health OK, 3 - ASIC in booting state.
0007
0008 The files are read only.
0009
0010 What: /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/cpld1_version
0011 What: /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/cpld2_version
0012 Date: June 2018
0013 KernelVersion: 4.19
0014 Contact: Vadim Pasternak <vadimp@nvidia.com>
0015 Description: These files show with which CPLD versions have been burned
0016 on carrier and switch boards.
0017
0018 The files are read only.
0019
0020 What: /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/fan_dir
0021 Date: December 2018
0022 KernelVersion: 5.0
0023 Contact: Vadim Pasternak <vadimp@nvidia.com>
0024 Description: This file shows the system fans direction:
0025 forward direction - relevant bit is set 0;
0026 reversed direction - relevant bit is set 1.
0027
0028 The files are read only.
0029
0030 What: /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/cpld3_version
0031 Date: November 2018
0032 KernelVersion: 5.0
0033 Contact: Vadim Pasternak <vadimp@nvidia.com>
0034 Description: These files show with which CPLD versions have been burned
0035 on LED or Gearbox board.
0036
0037 The files are read only.
0038
0039 What: /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/jtag_enable
0040 Date: November 2018
0041 KernelVersion: 5.0
0042 Contact: Vadim Pasternak <vadimp@nvidia.com>
0043 Description: These files enable and disable the access to the JTAG domain.
0044 By default access to the JTAG domain is disabled.
0045
0046 The file is read/write.
0047
0048 What: /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/select_iio
0049 Date: June 2018
0050 KernelVersion: 4.19
0051 Contact: Vadim Pasternak <vadimp@nvidia.com>
0052 Description: This file allows iio devices selection.
0053
0054 Attribute select_iio can be written with 0 or with 1. It
0055 selects which one of iio devices can be accessed.
0056
0057 The file is read/write.
0058
0059 What: /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/psu1_on
0060 /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/psu2_on
0061 /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/pwr_cycle
0062 /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/pwr_down
0063 Date: June 2018
0064 KernelVersion: 4.19
0065 Contact: Vadim Pasternak <vadimp@nvidia.com>
0066 Description: These files allow asserting system power cycling, switching
0067 power supply units on and off and system's main power domain
0068 shutdown.
0069 Expected behavior:
0070 When pwr_cycle is written 1: auxiliary power domain will go
0071 down and after short period (about 1 second) up.
0072 When psu1_on or psu2_on is written 1, related unit will be
0073 disconnected from the power source, when written 0 - connected.
0074 If both are written 1 - power supplies main power domain will
0075 go down.
0076 When pwr_down is written 1, system's main power domain will go
0077 down.
0078
0079 The files are write only.
0080
0081 What: /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/reset_aux_pwr_or_ref
0082 What: /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/reset_asic_thermal
0083 What: /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/reset_hotswap_or_halt
0084 What: /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/reset_hotswap_or_wd
0085 What: /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/reset_fw_reset
0086 What: /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/reset_long_pb
0087 What: /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/reset_main_pwr_fail
0088 What: /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/reset_short_pb
0089 What: /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/reset_sw_reset
0090 Date: June 2018
0091 KernelVersion: 4.19
0092 Contact: Vadim Pasternak <vadimp@nvidia.com>
0093 Description: These files show the system reset cause, as following: power
0094 auxiliary outage or power refresh, ASIC thermal shutdown, halt,
0095 hotswap, watchdog, firmware reset, long press power button,
0096 short press power button, software reset. Value 1 in file means
0097 this is reset cause, 0 - otherwise. Only one of the above
0098 causes could be 1 at the same time, representing only last
0099 reset cause.
0100
0101 The files are read only.
0102
0103 What: /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/reset_comex_pwr_fail
0104 What: /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/reset_from_comex
0105 What: /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/reset_system
0106 What: /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/reset_voltmon_upgrade_fail
0107 Date: November 2018
0108 KernelVersion: 5.0
0109 Contact: Vadim Pasternak <vadimp@nvidia.com>
0110 Description: These files show the system reset cause, as following: ComEx
0111 power fail, reset from ComEx, system platform reset, reset
0112 due to voltage monitor devices upgrade failure,
0113 Value 1 in file means this is reset cause, 0 - otherwise.
0114 Only one bit could be 1 at the same time, representing only
0115 the last reset cause.
0116
0117 The files are read only.
0118
0119 What: /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/cpld4_version
0120 Date: November 2018
0121 KernelVersion: 5.0
0122 Contact: Vadim Pasternak <vadimp@nvidia.com>
0123 Description: These files show with which CPLD versions have been burned
0124 on LED board.
0125
0126 The files are read only.
0127
0128 What: /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/reset_comex_thermal
0129 What: /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/reset_comex_wd
0130 What: /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/reset_from_asic
0131 What: /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/reset_reload_bios
0132 What: /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/reset_sff_wd
0133 What: /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/reset_swb_wd
0134 Date: June 2019
0135 KernelVersion: 5.3
0136 Contact: Vadim Pasternak <vadimp@nvidia.com>
0137 Description: These files show the system reset cause, as following:
0138 COMEX thermal shutdown; wathchdog power off or reset was derived
0139 by one of the next components: COMEX, switch board or by Small Form
0140 Factor mezzanine, reset requested from ASIC, reset caused by BIOS
0141 reload. Value 1 in file means this is reset cause, 0 - otherwise.
0142 Only one of the above causes could be 1 at the same time, representing
0143 only last reset cause.
0144
0145 The files are read only.
0146
0147 What: /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/config1
0148 What: /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/config2
0149 Date: January 2020
0150 KernelVersion: 5.6
0151 Contact: Vadim Pasternak <vadimp@nvidia.com>
0152 Description: These files show system static topology identification
0153 like system's static I2C topology, number and type of FPGA
0154 devices within the system and so on.
0155
0156 The files are read only.
0157
0158 What: /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/reset_ac_pwr_fail
0159 What: /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/reset_platform
0160 What: /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/reset_soc
0161 What: /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/reset_sw_pwr_off
0162 Date: January 2020
0163 KernelVersion: 5.6
0164 Contact: Vadim Pasternak <vadimp@nvidia.com>
0165 Description: These files show the system reset causes, as following: reset
0166 due to AC power failure, reset invoked from software by
0167 assertion reset signal through CPLD. reset caused by signal
0168 asserted by SOC through ACPI register, reset invoked from
0169 software by assertion power off signal through CPLD.
0170
0171 The files are read only.
0172
0173 What: /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/pcie_asic_reset_dis
0174 Date: January 2020
0175 KernelVersion: 5.6
0176 Contact: Vadim Pasternak <vadimp@nvidia.com>
0177 Description: This file allows to retain ASIC up during PCIe root complex
0178 reset, when attribute is set 1.
0179
0180 The file is read/write.
0181
0182 What: /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/vpd_wp
0183 Date: January 2020
0184 KernelVersion: 5.6
0185 Contact: Vadim Pasternak <vadimp@nvidia.com>
0186 Description: This file allows to overwrite system VPD hardware write
0187 protection when attribute is set 1.
0188
0189 The file is read/write.
0190
0191 What: /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/voltreg_update_status
0192 Date: January 2020
0193 KernelVersion: 5.6
0194 Contact: Vadim Pasternak <vadimp@nvidia.com>
0195 Description: This file exposes the configuration update status of burnable
0196 voltage regulator devices. The status values are as following:
0197 0 - OK; 1 - CRC failure; 2 = I2C failure; 3 - in progress.
0198
0199 The file is read only.
0200
0201 What: /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/ufm_version
0202 Date: January 2020
0203 KernelVersion: 5.6
0204 Contact: Vadim Pasternak <vadimp@nvidia.com>
0205 Description: This file exposes the firmware version of burnable voltage
0206 regulator devices.
0207
0208 The file is read only.
0209
0210 What: /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/cpld1_pn
0211 What: /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/cpld2_pn
0212 What: /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/cpld3_pn
0213 What: /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/cpld4_pn
0214 What: /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/cpld1_version_min
0215 What: /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/cpld2_version_min
0216 What: /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/cpld3_version_min
0217 What: /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/cpld4_version_min
0218 Date: July 2020
0219 KernelVersion: 5.9
0220 Contact: Vadim Pasternak <vadimp@nvidia.com>
0221 Description: These files show with which CPLD part numbers and minor
0222 versions have been burned CPLD devices equipped on a
0223 system.
0224
0225 The files are read only.
0226
0227 What: /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/bios_active_image
0228 What: /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/bios_auth_fail
0229 What: /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/bios_upgrade_fail
0230 Date: October 2021
0231 KernelVersion: 5.16
0232 Contact: Vadim Pasternak <vadimp@nvidia.com>
0233 Description: The files represent BIOS statuses:
0234
0235 bios_active_image: location of current active BIOS image:
0236 0: Top, 1: Bottom.
0237 The reported value should correspond to value expected by OS
0238 in case of BIOS safe mode is 0. This bit is related to Intel
0239 top-swap feature of DualBios on the same flash.
0240
0241 bios_auth_fail: BIOS upgrade is failed because provided BIOS
0242 image is not signed correctly.
0243
0244 bios_upgrade_fail: BIOS upgrade is failed by some other
0245 reason not because authentication. For example due to
0246 physical SPI flash problem.
0247
0248 The files are read only.
0249
0250 What: /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/lc1_enable
0251 What: /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/lc2_enable
0252 What: /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/lc3_enable
0253 What: /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/lc4_enable
0254 What: /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/lc5_enable
0255 What: /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/lc6_enable
0256 What: /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/lc7_enable
0257 What: /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/lc8_enable
0258 Date: October 2021
0259 KernelVersion: 5.16
0260 Contact: Vadim Pasternak <vadimp@nvidia.com>
0261 Description: These files allow line cards enable state control.
0262 Expected behavior:
0263 When lc{n}_enable is written 1, related line card is released
0264 from the reset state, when 0 - is hold in reset state.
0265
0266 The files are read/write.
0267
0268 What: /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/lc1_pwr
0269 What: /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/lc2_pwr
0270 What: /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/lc3_pwr
0271 What: /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/lc4_pwr
0272 What: /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/lc5_pwr
0273 What: /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/lc6_pwr
0274 What: /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/lc7_pwr
0275 What: /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/lc8_pwr
0276 Date: October 2021
0277 KernelVersion: 5.16
0278 Contact: Vadim Pasternak <vadimp@nvidia.com>
0279 Description: These files switching line cards power on and off.
0280 Expected behavior:
0281 When lc{n}_pwr is written 1, related line card is powered
0282 on, when written 0 - powered off.
0283
0284 The files are read/write.
0285
0286 What: /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/lc1_rst_mask
0287 What: /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/lc2_rst_mask
0288 What: /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/lc3_rst_mask
0289 What: /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/lc4_rst_mask
0290 What: /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/lc5_rst_mask
0291 What: /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/lc6_rst_mask
0292 What: /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/lc7_rst_mask
0293 What: /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/lc8_rst_mask
0294 Date: October 2021
0295 KernelVersion: 5.16
0296 Contact: Vadim Pasternak <vadimp@nvidia.com>
0297 Description: These files clear line card reset bit enforced by ASIC, when it
0298 sets it due to some abnormal ASIC behavior.
0299 Expected behavior:
0300 When lc{n}_rst_mask is written 1, related line card reset bit
0301 is cleared, when written 0 - no effect.
0302
0303 The files are write only.
0304
0305 What: /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/os_started
0306 Date: October 2021
0307 KernelVersion: 5.16
0308 Contact: Vadim Pasternak <vadimp@nvidia.com>
0309 Description: This file, when written 1, indicates to programmable devices
0310 that OS is taking control over it.
0311
0312 The file is read/write.
0313
0314 What: /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/pm_mgmt_en
0315 Date: October 2021
0316 KernelVersion: 5.16
0317 Contact: Vadim Pasternak <vadimp@nvidia.com>
0318 Description: This file assigns power management control ownership.
0319 When power management control is provided by hardware, hardware
0320 will automatically power off one or more line previously
0321 powered line cards in case system power budget is getting
0322 insufficient. It could be in case when some of power units lost
0323 power good state.
0324 When pm_mgmt_en is written 1, power management control by
0325 software is enabled, 0 - power management control by hardware.
0326 Note that for any setting of pm_mgmt_en attribute hardware will
0327 not allow to power on any new line card in case system power
0328 budget is insufficient.
0329 Same in case software will try to power on several line cards
0330 at once - hardware will power line cards while system has
0331 enough power budget.
0332 Default is 0.
0333
0334 The file is read/write.
0335
0336 What: /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/psu3_on
0337 What: /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/psu4_on
0338 Date: October 2021
0339 KernelVersion: 5.16
0340 Contact: Vadim Pasternak <vadimp@nvidia.com>
0341 Description: These files switching power supply units on and off.
0342 Expected behavior:
0343 When psu3_on or psu4_on is written 1, related unit will be
0344 disconnected from the power source, when written 0 - connected.
0345
0346 The files are write only.
0347
0348 What: /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/shutdown_unlock
0349 Date: October 2021
0350 KernelVersion: 5.16
0351 Contact: Vadim Pasternak <vadimp@nvidia.com>
0352 Description: This file allows to unlock ASIC after thermal shutdown event.
0353 When system thermal shutdown is enforced by ASIC, ASIC is
0354 getting locked and after system boot it will not be available.
0355 Software can decide to unlock it by setting this attribute to
0356 1 and then perform system power cycle by setting pwr_cycle
0357 attribute to 1 (power cycle of main power domain).
0358 Before setting shutdown_unlock to 1 it is recommended to
0359 validate that system reboot cause is reset_asic_thermal or
0360 reset_thermal_spc_or_pciesw.
0361 In case shutdown_unlock is not set 1, the only way to release
0362 ASIC from locking - is full system power cycle through the
0363 external power distribution unit.
0364 Default is 1.
0365
0366 The file is read/write.
0367
0368 What: /sys/devices/platform/mlxplat/i2c_mlxcpld.*/i2c-*/i2c-*/i2c-*/*-0032/mlxreg-io.*/hwmon/hwmon*/cpld1_pn
0369 What: /sys/devices/platform/mlxplat/i2c_mlxcpld.*/i2c-*/i2c-*/i2c-*/*-0032/mlxreg-io.*/hwmon/hwmon*/cpld1_version
0370 What: /sys/devices/platform/mlxplat/i2c_mlxcpld.*/i2c-*/i2c-*/i2c-*/*-0032/mlxreg-io.*/hwmon/hwmon*/cpld1_version_min
0371 Date: October 2021
0372 KernelVersion: 5.16
0373 Contact: Vadim Pasternak <vadimp@nvidia.com>
0374 Description: These files show with which CPLD major and minor versions
0375 and part number has been burned CPLD device on line card.
0376
0377 The files are read only.
0378
0379 What: /sys/devices/platform/mlxplat/i2c_mlxcpld.*/i2c-*/i2c-*/i2c-*/*-0032/mlxreg-io.*/hwmon/hwmon*/fpga1_pn
0380 What: /sys/devices/platform/mlxplat/i2c_mlxcpld.*/i2c-*/i2c-*/i2c-*/*-0032/mlxreg-io.*/hwmon/hwmon*/fpga1_version
0381 What: /sys/devices/platform/mlxplat/i2c_mlxcpld.*/i2c-*/i2c-*/i2c-*/*-0032/mlxreg-io.*/hwmon/hwmon*/fpga1_version_min
0382 Date: October 2021
0383 KernelVersion: 5.16
0384 Contact: Vadim Pasternak <vadimp@nvidia.com>
0385 Description: These files show with which FPGA major and minor versions
0386 and part number has been burned FPGA device on line card.
0387
0388 The files are read only.
0389
0390 What: /sys/devices/platform/mlxplat/i2c_mlxcpld.*/i2c-*/i2c-*/i2c-*/*-0032/mlxreg-io.*/hwmon/hwmon*/vpd_wp
0391 Date: October 2021
0392 KernelVersion: 5.16
0393 Contact: Vadim Pasternak <vadimp@nvidia.com>
0394 Description: This file allow to overwrite line card VPD hardware write
0395 protection mode. When attribute is set 1 - write protection is
0396 disabled, when 0 - enabled.
0397 Default is 0.
0398 If the system is in locked-down mode writing this file will not
0399 be allowed.
0400 The purpose if this file is to allow line card VPD burning
0401 during production flow.
0402
0403 The file is read/write.
0404
0405 What: /sys/devices/platform/mlxplat/i2c_mlxcpld.*/i2c-*/i2c-*/i2c-*/*-0032/mlxreg-io.*/hwmon/hwmon*/reset_aux_pwr_or_ref
0406 What: /sys/devices/platform/mlxplat/i2c_mlxcpld.*/i2c-*/i2c-*/i2c-*/*-0032/mlxreg-io.*/hwmon/hwmon*/reset_dc_dc_pwr_fail
0407 What: /sys/devices/platform/mlxplat/i2c_mlxcpld.*/i2c-*/i2c-*/i2c-*/*-0032/mlxreg-io.*/hwmon/hwmon*/reset_fpga_not_done
0408 What: /sys/devices/platform/mlxplat/i2c_mlxcpld.*/i2c-*/i2c-*/i2c-*/*-0032/mlxreg-io.*/hwmon/hwmon*/reset_from_chassis
0409 What: /sys/devices/platform/mlxplat/i2c_mlxcpld.*/i2c-*/i2c-*/i2c-*/*-0032/mlxreg-io.*/hwmon/hwmon*/reset_line_card
0410 What: /sys/devices/platform/mlxplat/i2c_mlxcpld.*/i2c-*/i2c-*/i2c-*/*-0032/mlxreg-io.*/hwmon/hwmon*/reset_pwr_off_from_chassis
0411 Date: October 2021
0412 KernelVersion: 5.16
0413 Contact: Vadim Pasternak <vadimp@nvidia.com>
0414 Description: These files show the line reset cause, as following: power
0415 auxiliary outage or power refresh, DC-to-DC power failure, FPGA reset
0416 failed, line card reset failed, power off from chassis.
0417 Value 1 in file means this is reset cause, 0 - otherwise. Only one of
0418 the above causes could be 1 at the same time, representing only last
0419 reset cause.
0420
0421 The files are read only.
0422
0423 What: /sys/devices/platform/mlxplat/i2c_mlxcpld.*/i2c-*/i2c-*/i2c-*/*-0032/mlxreg-io.*/hwmon/hwmon*/cpld_upgrade_en
0424 What: /sys/devices/platform/mlxplat/i2c_mlxcpld.*/i2c-*/i2c-*/i2c-*/*-0032/mlxreg-io.*/hwmon/hwmon*/fpga_upgrade_en
0425 Date: October 2021
0426 KernelVersion: 5.16
0427 Contact: Vadim Pasternak <vadimp@nvidia.com>
0428 Description: These files allow CPLD and FPGA burning. Value 1 in file means burning
0429 is enabled, 0 - otherwise.
0430 If the system is in locked-down mode writing these files will
0431 not be allowed.
0432 The purpose of these files to allow line card CPLD and FPGA
0433 upgrade through the JTAG daisy-chain.
0434
0435 The files are read/write.
0436
0437 What: /sys/devices/platform/mlxplat/i2c_mlxcpld.*/i2c-*/i2c-*/i2c-*/*-0032/mlxreg-io.*/hwmon/hwmon*/qsfp_pwr_en
0438 What: /sys/devices/platform/mlxplat/i2c_mlxcpld.*/i2c-*/i2c-*/i2c-*/*-0032/mlxreg-io.*/hwmon/hwmon*/pwr_en
0439 Date: October 2021
0440 KernelVersion: 5.16
0441 Contact: Vadim Pasternak <vadimp@nvidia.com>
0442 Description: These files allow to power on/off all QSFP ports and whole line card.
0443 The attributes are set 1 for power on, 0 - for power off.
0444
0445 The files are read/write.
0446
0447 What: /sys/devices/platform/mlxplat/i2c_mlxcpld.*/i2c-*/i2c-*/i2c-*/*-0032/mlxreg-io.*/hwmon/hwmon*/agb_spi_burn_en
0448 What: /sys/devices/platform/mlxplat/i2c_mlxcpld.*/i2c-*/i2c-*/i2c-*/*-0032/mlxreg-io.*/hwmon/hwmon*/fpga_spi_burn_en
0449 Date: October 2021
0450 KernelVersion: 5.16
0451 Contact: Vadim Pasternak <vadimp@nvidia.com>
0452 Description: These files allow gearboxes and FPGA SPI flash burning.
0453 The attributes are set 1 to enable burning, 0 - to disable.
0454 If the system is in locked-down mode writing these files will
0455 not be allowed.
0456 The purpose of these files to allow line card Gearboxes and FPGA
0457 burning during production flow.
0458
0459 The file is read/write.
0460
0461 What: /sys/devices/platform/mlxplat/i2c_mlxcpld.*/i2c-*/i2c-*/i2c-*/*-0032/mlxreg-io.*/hwmon/hwmon*/max_power
0462 What: /sys/devices/platform/mlxplat/i2c_mlxcpld.*/i2c-*/i2c-*/i2c-*/*-0032/mlxreg-io.*/hwmon/hwmon*/config
0463 Date: October 2021
0464 KernelVersion: 5.16
0465 Contact: Vadim Pasternak <vadimp@nvidia.com>
0466 Description: These files provide the maximum powered required for line card
0467 feeding and line card configuration Id.
0468
0469 The files are read only.
0470
0471 What: /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/phy_reset
0472 Date: May 2022
0473 KernelVersion: 5.19
0474 Contact: Vadim Pasternak <vadimp@nvidia.com>
0475 Description: This file allows to reset PHY 88E1548 when attribute is set 0
0476 due to some abnormal PHY behavior.
0477 Expected behavior:
0478 When phy_reset is written 1, all PHY 88E1548 are released
0479 from the reset state, when 0 - are hold in reset state.
0480
0481 The files are read/write.
0482
0483 What: /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/mac_reset
0484 Date: May 2022
0485 KernelVersion: 5.19
0486 Contact: Vadim Pasternak <vadimp@nvidia.com>
0487 Description: This file allows to reset ASIC MT52132 when attribute is set 0
0488 due to some abnormal ASIC behavior.
0489 Expected behavior:
0490 When mac_reset is written 1, the ASIC MT52132 is released
0491 from the reset state, when 0 - is hold in reset state.
0492
0493 The files are read/write.
0494
0495 What: /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/qsfp_pwr_good
0496 Date: May 2022
0497 KernelVersion: 5.19
0498 Contact: Vadim Pasternak <vadimp@nvidia.com>
0499 Description: This file shows QSFP ports power status. The value is set to 0
0500 when one of any QSFP ports is plugged. The value is set to 1 when
0501 there are no any QSFP ports are plugged.
0502 The possible values are:
0503 0 - Power good, 1 - Not power good.
0504
0505 The files are read only.
0506
0507 What: /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/asic2_health
0508 Date: July 2022
0509 KernelVersion: 5.20
0510 Contact: Vadim Pasternak <vadimp@nvidia.com>
0511 Description: This file shows 2-nd ASIC health status. The possible values are:
0512 0 - health failed, 2 - health OK, 3 - ASIC in booting state.
0513
0514 The file is read only.
0515
0516 What: /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/asic_reset
0517 What: /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/asic2_reset
0518 Date: July 2022
0519 KernelVersion: 5.20
0520 Contact: Vadim Pasternak <vadimp@nvidia.com>
0521 Description: These files allow to each of ASICs by writing 1.
0522
0523 The files are write only.
0524
0525
0526 What: /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/comm_chnl_ready
0527 Date: July 2022
0528 KernelVersion: 5.20
0529 Contact: Vadim Pasternak <vadimp@nvidia.com>
0530 Description: This file is used to indicate remote end (for example BMC) that system
0531 host CPU is ready for sending telemetry data to remote end.
0532 For indication the file should be written 1.
0533
0534 The file is write only.
0535
0536 What: /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/config3
0537 Date: January 2020
0538 KernelVersion: 5.6
0539 Contact: Vadim Pasternak <vadimp@nvidia.com>
0540 Description: The file indicates COME module hardware configuration.
0541 The value is pushed by hardware through GPIO pins.
0542 The purpose is to expose some minor BOM changes for the same system SKU.
0543
0544 The file is read only.
