| Wilken Gottwalt | d115b51 | 2020-10-27 14:17:10 +0100 | [diff] [blame] | 1 | .. SPDX-License-Identifier: GPL-2.0-or-later |
| 2 | |
| 3 | Kernel driver corsair-psu |
| 4 | ========================= |
| 5 | |
| 6 | Supported devices: |
| 7 | |
| 8 | * Corsair Power Supplies |
| 9 | |
| 10 | Corsair HX550i |
| 11 | |
| 12 | Corsair HX650i |
| 13 | |
| 14 | Corsair HX750i |
| 15 | |
| 16 | Corsair HX850i |
| 17 | |
| 18 | Corsair HX1000i |
| 19 | |
| 20 | Corsair HX1200i |
| 21 | |
| 22 | Corsair RM550i |
| 23 | |
| 24 | Corsair RM650i |
| 25 | |
| 26 | Corsair RM750i |
| 27 | |
| 28 | Corsair RM850i |
| 29 | |
| 30 | Corsair RM1000i |
| 31 | |
| 32 | Author: Wilken Gottwalt |
| 33 | |
| 34 | Description |
| 35 | ----------- |
| 36 | |
| 37 | This driver implements the sysfs interface for the Corsair PSUs with a HID protocol |
| 38 | interface of the HXi and RMi series. |
| 39 | These power supplies provide access to a micro-controller with 2 attached |
| 40 | temperature sensors, 1 fan rpm sensor, 4 sensors for volt levels, 4 sensors for |
| 41 | power usage and 4 sensors for current levels and addtional non-sensor information |
| 42 | like uptimes. |
| 43 | |
| 44 | Sysfs entries |
| 45 | ------------- |
| 46 | |
| 47 | ======================= ======================================================== |
| 48 | curr1_input Total current usage |
| 49 | curr2_input Current on the 12v psu rail |
| Wilken Gottwalt | c2d5f27 | 2021-03-18 15:17:14 +0100 | [diff] [blame] | 50 | curr2_crit Current max critical value on the 12v psu rail |
| Wilken Gottwalt | d115b51 | 2020-10-27 14:17:10 +0100 | [diff] [blame] | 51 | curr3_input Current on the 5v psu rail |
| Wilken Gottwalt | c2d5f27 | 2021-03-18 15:17:14 +0100 | [diff] [blame] | 52 | curr3_crit Current max critical value on the 5v psu rail |
| Wilken Gottwalt | d115b51 | 2020-10-27 14:17:10 +0100 | [diff] [blame] | 53 | curr4_input Current on the 3.3v psu rail |
| Wilken Gottwalt | c2d5f27 | 2021-03-18 15:17:14 +0100 | [diff] [blame] | 54 | curr4_crit Current max critical value on the 3.3v psu rail |
| Wilken Gottwalt | d115b51 | 2020-10-27 14:17:10 +0100 | [diff] [blame] | 55 | fan1_input RPM of psu fan |
| 56 | in0_input Voltage of the psu ac input |
| 57 | in1_input Voltage of the 12v psu rail |
| Wilken Gottwalt | c2d5f27 | 2021-03-18 15:17:14 +0100 | [diff] [blame] | 58 | in1_crit Voltage max critical value on the 12v psu rail |
| 59 | in1_lcrit Voltage min critical value on the 12v psu rail |
| Wilken Gottwalt | d115b51 | 2020-10-27 14:17:10 +0100 | [diff] [blame] | 60 | in2_input Voltage of the 5v psu rail |
| Wilken Gottwalt | c2d5f27 | 2021-03-18 15:17:14 +0100 | [diff] [blame] | 61 | in2_crit Voltage max critical value on the 5v psu rail |
| 62 | in2_lcrit Voltage min critical value on the 5v psu rail |
| 63 | in3_input Voltage of the 3.3v psu rail |
| 64 | in3_crit Voltage max critical value on the 3.3v psu rail |
| 65 | in3_lcrit Voltage min critical value on the 3.3v psu rail |
| Wilken Gottwalt | d115b51 | 2020-10-27 14:17:10 +0100 | [diff] [blame] | 66 | power1_input Total power usage |
| 67 | power2_input Power usage of the 12v psu rail |
| 68 | power3_input Power usage of the 5v psu rail |
| 69 | power4_input Power usage of the 3.3v psu rail |
| 70 | temp1_input Temperature of the psu vrm component |
| Wilken Gottwalt | c2d5f27 | 2021-03-18 15:17:14 +0100 | [diff] [blame] | 71 | temp1_crit Temperature max cirtical value of the psu vrm component |
| Wilken Gottwalt | d115b51 | 2020-10-27 14:17:10 +0100 | [diff] [blame] | 72 | temp2_input Temperature of the psu case |
| Wilken Gottwalt | c2d5f27 | 2021-03-18 15:17:14 +0100 | [diff] [blame] | 73 | temp2_crit Temperature max critical value of psu case |
| Wilken Gottwalt | d115b51 | 2020-10-27 14:17:10 +0100 | [diff] [blame] | 74 | ======================= ======================================================== |
| 75 | |
| 76 | Usage Notes |
| 77 | ----------- |
| 78 | |
| 79 | It is an USB HID device, so it is auto-detected and supports hot-swapping. |
| 80 | |
| 81 | Flickering values in the rail voltage levels can be an indicator for a failing |
| 82 | PSU. The driver also provides some additional useful values via debugfs, which |
| 83 | do not fit into the hwmon class. |
| 84 | |
| 85 | Debugfs entries |
| 86 | --------------- |
| 87 | |
| 88 | ======================= ======================================================== |
| 89 | uptime Current uptime of the psu |
| 90 | uptime_total Total uptime of the psu |
| 91 | vendor Vendor name of the psu |
| 92 | product Product name of the psu |
| 93 | ======================= ======================================================== |