Documentation/ABI/stable/sysfs-driver-mlxreg-io

   1 What:           /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/asic_health
   2 Date:           June 2018
   3 KernelVersion:  4.19
   4 Contact:        Vadim Pasternak <vadimpmellanox.com>
   5 Description:    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
  10 What:           /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/cpld1_version
  11 What:           /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/cpld2_version
  12 Date:           June 2018
  13 KernelVersion:  4.19
  14 Contact:        Vadim Pasternak <vadimpmellanox.com>
  15 Description:    These files show with which CPLD versions have been burned
  16                 on carrier and switch boards.
  17
  18                 The files are read only.
  19
  20 What:           /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/fan_dir
  21 Date:           December 2018
  22 KernelVersion:  5.0
  23 Contact:        Vadim Pasternak <vadimpmellanox.com>
  24 Description:    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
  30 What:           /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/cpld3_version
  31 Date:           November 2018
  32 KernelVersion:  5.0
  33 Contact:        Vadim Pasternak <vadimpmellanox.com>
  34 Description:    These files show with which CPLD versions have been burned
  35                 on LED or Gearbox board.
  36
  37                 The files are read only.
  38
  39 What:           /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/jtag_enable
  40 Date:           November 2018
  41 KernelVersion:  5.0
  42 Contact:        Vadim Pasternak <vadimpmellanox.com>
  43 Description:    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
  48 What:           /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/select_iio
  49 Date:           June 2018
  50 KernelVersion:  4.19
  51 Contact:        Vadim Pasternak <vadimpmellanox.com>
  52 Description:    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
  59 What:           /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
  63 Date:           June 2018
  64 KernelVersion:  4.19
  65 Contact:        Vadim Pasternak <vadimpmellanox.com>
  66 Description:    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
  81 What:           /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/reset_aux_pwr_or_ref
  82 What:           /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/reset_asic_thermal
  83 What:           /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/reset_hotswap_or_halt
  84 What:           /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/reset_hotswap_or_wd
  85 What:           /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/reset_fw_reset
  86 What:           /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/reset_long_pb
  87 What:           /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/reset_main_pwr_fail
  88 What:           /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/reset_short_pb
  89 What:           /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/reset_sw_reset
  90 Date:           June 2018
  91 KernelVersion:  4.19
  92 Contact:        Vadim Pasternak <vadimpmellanox.com>
  93 Description:    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
 103 What:           /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/reset_comex_pwr_fail
 104 What:           /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/reset_from_comex
 105 What:           /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/reset_system
 106 What:           /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/reset_voltmon_upgrade_fail
 107 Date:           November 2018
 108 KernelVersion:  5.0
 109 Contact:        Vadim Pasternak <vadimpmellanox.com>
 110 Description:    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
 119 What:           /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/cpld4_version
 120 Date:           November 2018
 121 KernelVersion:  5.0
 122 Contact:        Vadim Pasternak <vadimpmellanox.com>
 123 Description:    These files show with which CPLD versions have been burned
 124                 on LED board.
 125
 126                 The files are read only.
 127
 128 What:           /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/reset_comex_thermal
 129 What:           /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/reset_comex_wd
 130 What:           /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/reset_from_asic
 131 What:           /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/reset_reload_bios
 132 What:           /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/reset_sff_wd
 133 What:           /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/reset_swb_wd
 134 Date:           June 2019
 135 KernelVersion:  5.3
 136 Contact:        Vadim Pasternak <vadimpmellanox.com>
 137 Description:    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 caused 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
 147 What:           /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/config1
 148 What:           /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/config2
 149 Date:           January 2020
 150 KernelVersion:  5.6
 151 Contact:        Vadim Pasternak <vadimpmellanox.com>
 152 Description:    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
 158 What:           /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/reset_ac_pwr_fail
 159 What:           /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/reset_platform
 160 What:           /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/reset_soc
 161 What:           /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/reset_sw_pwr_off
 162 Date:           January 2020
 163 KernelVersion:  5.6
 164 Contact:        Vadim Pasternak <vadimpmellanox.com>
 165 Description:    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
 173 What:           /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/pcie_asic_reset_dis
 174 Date:           January 2020
 175 KernelVersion:  5.6
 176 Contact:        Vadim Pasternak <vadimpmellanox.com>
 177 Description:    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
 182 What:           /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/vpd_wp
 183 Date:           January 2020
 184 KernelVersion:  5.6
 185 Contact:        Vadim Pasternak <vadimpmellanox.com>
 186 Description:    This file allows to overwrite system VPD hardware write
 187                 protection when attribute is set 1.
 188
 189                 The file is read/write.
 190
 191 What:           /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/voltreg_update_status
 192 Date:           January 2020
 193 KernelVersion:  5.6
 194 Contact:        Vadim Pasternak <vadimpmellanox.com>
 195 Description:    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
 201 What:           /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/ufm_version
 202 Date:           January 2020
 203 KernelVersion:  5.6
 204 Contact:        Vadim Pasternak <vadimpmellanox.com>
 205 Description:    This file exposes the firmware version of burnable voltage
 206                 regulator devices.
 207
 208                 The file is read only.
 209
 210 What:           /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/cpld1_pn
 211 What:           /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/cpld2_pn
 212 What:           /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/cpld3_pn
 213 What:           /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/cpld4_pn
 214 What:           /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/cpld1_version_min
 215 What:           /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/cpld2_version_min
 216 What:           /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/cpld3_version_min
 217 What:           /sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/cpld4_version_min
 218 Date:           July 2020
 219 KernelVersion:  5.9
 220 Contact:        Vadim Pasternak <vadimpmellanox.com>
 221 Description:    These files show with which CPLD part numbers and minor
 222                 versions have been burned CPLD devices equipped on a
 223                 system.
 224
 225                 The files are read only.