xref: /linux/Documentation/hwmon/corsair-psu.rst (revision a1ff5a7d78a036d6c2178ee5acd6ba4946243800)
1d115b51eSWilken Gottwalt.. SPDX-License-Identifier: GPL-2.0-or-later
2d115b51eSWilken Gottwalt
3d115b51eSWilken GottwaltKernel driver corsair-psu
4d115b51eSWilken Gottwalt=========================
5d115b51eSWilken Gottwalt
6d115b51eSWilken GottwaltSupported devices:
7d115b51eSWilken Gottwalt
8d115b51eSWilken Gottwalt* Corsair Power Supplies
9d115b51eSWilken Gottwalt
10d115b51eSWilken Gottwalt  Corsair HX550i
11d115b51eSWilken Gottwalt
12d115b51eSWilken Gottwalt  Corsair HX650i
13d115b51eSWilken Gottwalt
14d115b51eSWilken Gottwalt  Corsair HX750i
15d115b51eSWilken Gottwalt
16d115b51eSWilken Gottwalt  Corsair HX850i
17d115b51eSWilken Gottwalt
18*b9c15c96SWilken Gottwalt  Corsair HX1000i (Legacy and Series 2023)
19d115b51eSWilken Gottwalt
20*b9c15c96SWilken Gottwalt  Corsair HX1200i (Legacy and Series 2023)
21d115b51eSWilken Gottwalt
22*b9c15c96SWilken Gottwalt  Corsair HX1500i (Legacy and Series 2023)
235619c660SWilken Gottwalt
24d115b51eSWilken Gottwalt  Corsair RM550i
25d115b51eSWilken Gottwalt
26d115b51eSWilken Gottwalt  Corsair RM650i
27d115b51eSWilken Gottwalt
28d115b51eSWilken Gottwalt  Corsair RM750i
29d115b51eSWilken Gottwalt
30d115b51eSWilken Gottwalt  Corsair RM850i
31d115b51eSWilken Gottwalt
32d115b51eSWilken Gottwalt  Corsair RM1000i
33d115b51eSWilken Gottwalt
34d115b51eSWilken GottwaltAuthor: Wilken Gottwalt
35d115b51eSWilken Gottwalt
36d115b51eSWilken GottwaltDescription
37d115b51eSWilken Gottwalt-----------
38d115b51eSWilken Gottwalt
39d115b51eSWilken GottwaltThis driver implements the sysfs interface for the Corsair PSUs with a HID protocol
40d115b51eSWilken Gottwaltinterface of the HXi and RMi series.
41d115b51eSWilken GottwaltThese power supplies provide access to a micro-controller with 2 attached
42d115b51eSWilken Gottwalttemperature sensors, 1 fan rpm sensor, 4 sensors for volt levels, 4 sensors for
4312087a36SRandy Dunlappower usage and 4 sensors for current levels and additional non-sensor information
44d115b51eSWilken Gottwaltlike uptimes.
45d115b51eSWilken Gottwalt
46d115b51eSWilken GottwaltSysfs entries
47d115b51eSWilken Gottwalt-------------
48d115b51eSWilken Gottwalt
49d115b51eSWilken Gottwalt=======================	========================================================
50d115b51eSWilken Gottwaltcurr1_input		Total current usage
51d115b51eSWilken Gottwaltcurr2_input		Current on the 12v psu rail
52c2d5f273SWilken Gottwaltcurr2_crit		Current max critical value on the 12v psu rail
53d115b51eSWilken Gottwaltcurr3_input		Current on the 5v psu rail
54c2d5f273SWilken Gottwaltcurr3_crit		Current max critical value on the 5v psu rail
55d115b51eSWilken Gottwaltcurr4_input		Current on the 3.3v psu rail
56c2d5f273SWilken Gottwaltcurr4_crit		Current max critical value on the 3.3v psu rail
57d115b51eSWilken Gottwaltfan1_input		RPM of psu fan
58d115b51eSWilken Gottwaltin0_input		Voltage of the psu ac input
59d115b51eSWilken Gottwaltin1_input		Voltage of the 12v psu rail
60c2d5f273SWilken Gottwaltin1_crit		Voltage max critical value on the 12v psu rail
61c2d5f273SWilken Gottwaltin1_lcrit		Voltage min critical value on the 12v psu rail
62d115b51eSWilken Gottwaltin2_input		Voltage of the 5v psu rail
63c2d5f273SWilken Gottwaltin2_crit		Voltage max critical value on the 5v psu rail
64c2d5f273SWilken Gottwaltin2_lcrit		Voltage min critical value on the 5v psu rail
65c2d5f273SWilken Gottwaltin3_input		Voltage of the 3.3v psu rail
66c2d5f273SWilken Gottwaltin3_crit		Voltage max critical value on the 3.3v psu rail
67c2d5f273SWilken Gottwaltin3_lcrit		Voltage min critical value on the 3.3v psu rail
68d115b51eSWilken Gottwaltpower1_input		Total power usage
69d115b51eSWilken Gottwaltpower2_input		Power usage of the 12v psu rail
70d115b51eSWilken Gottwaltpower3_input		Power usage of the 5v psu rail
71d115b51eSWilken Gottwaltpower4_input		Power usage of the 3.3v psu rail
720d67bbc4SWilken Gottwaltpwm1			PWM value, read only
730d67bbc4SWilken Gottwaltpwm1_enable		PWM mode, read only
74d115b51eSWilken Gottwalttemp1_input		Temperature of the psu vrm component
75c2d5f273SWilken Gottwalttemp1_crit		Temperature max cirtical value of the psu vrm component
76d115b51eSWilken Gottwalttemp2_input		Temperature of the psu case
77c2d5f273SWilken Gottwalttemp2_crit		Temperature max critical value of psu case
78d115b51eSWilken Gottwalt=======================	========================================================
79d115b51eSWilken Gottwalt
80d115b51eSWilken GottwaltUsage Notes
81d115b51eSWilken Gottwalt-----------
82d115b51eSWilken Gottwalt
83741ed085SWilken GottwaltIt is an USB HID device, so it is auto-detected, supports hot-swapping and
84741ed085SWilken Gottwaltseveral devices at once.
85d115b51eSWilken Gottwalt
86d115b51eSWilken GottwaltFlickering values in the rail voltage levels can be an indicator for a failing
87741ed085SWilken GottwaltPSU. Accordingly to the default automatic fan speed plan the fan starts at about
88741ed085SWilken Gottwalt30% of the wattage rating. If this does not happen, a fan failure is likely. The
89741ed085SWilken Gottwaltdriver also provides some additional useful values via debugfs, which do not fit
90741ed085SWilken Gottwaltinto the hwmon class.
91d115b51eSWilken Gottwalt
92d115b51eSWilken GottwaltDebugfs entries
93d115b51eSWilken Gottwalt---------------
94d115b51eSWilken Gottwalt
95d115b51eSWilken Gottwalt=======================	========================================================
96eb12f548SWilken Gottwaltocpmode                 Single or multi rail mode of the PCIe power connectors
97eb12f548SWilken Gottwaltproduct                 Product name of the psu
98eb12f548SWilken Gottwaltuptime			Session uptime of the psu
99d115b51eSWilken Gottwaltuptime_total		Total uptime of the psu
100d115b51eSWilken Gottwaltvendor			Vendor name of the psu
101d115b51eSWilken Gottwalt=======================	========================================================
102