Kernel driver corsair-psu

Corsair HXi·RMi PSU 지원

이 GPL-2.0-or-later driver는 Corsair HX550i, HX650i, HX750i, HX850i, HX1000i Legacy·Series 2023, HX1200i Legacy·Series 2023·Series 2025, HX1500i Legacy·Series 2023을 지원합니다.

RMi 계열은 RM550i, RM650i, RM750i, RM850i, RM1000i를 지원합니다. 저자는 Wilken Gottwalt입니다.

HXi와 RMi series의 HID protocol interface를 사용하는 PSU에 sysfs interface를 제공합니다. Micro-controller에는 temperature sensor 2개, fan RPM sensor 1개, voltage sensor 4개, power usage sensor 4개, current sensor 4개가 연결되어 있고 uptime 같은 비-sensor 정보도 제공합니다.

.. SPDX-License-Identifier: GPL-2.0-or-later

Kernel driver corsair-psu
=========================

Supported devices:

* Corsair Power Supplies

  Corsair HX550i

  Corsair HX650i

  Corsair HX750i

  Corsair HX850i

  Corsair HX1000i (Legacy and Series 2023)

  Corsair HX1200i (Legacy, Series 2023 and Series 2025)

  Corsair HX1500i (Legacy and Series 2023)

  Corsair RM550i

  Corsair RM650i

  Corsair RM750i

  Corsair RM850i

  Corsair RM1000i

Author: Wilken Gottwalt

Description
-----------

This driver implements the sysfs interface for the Corsair PSUs with a HID protocol
interface of the HXi and RMi series.
These power supplies provide access to a micro-controller with 2 attached
temperature sensors, 1 fan rpm sensor, 4 sensors for volt levels, 4 sensors for
power usage and 4 sensors for current levels and additional non-sensor information
like uptimes.

Corsair PSU sysfs

`curr1_input`은 total current usage입니다. `curr2`, `curr3`, `curr4`는 각각 12V, 5V, 3.3V rail current이며 각 `curr#_crit`은 maximum critical current입니다.

`fan1_input`은 PSU fan RPM입니다. `in0_input`은 PSU AC input voltage이고 `in1`, `in2`, `in3`은 12V, 5V, 3.3V rail voltage입니다. 각 DC rail에는 maximum critical `in#_crit`과 minimum critical `in#_lcrit`이 있습니다.

`power1_input`은 total power usage이고 `power2`, `power3`, `power4`는 12V, 5V, 3.3V rail power입니다. `pwm1`은 read-only PWM value, `pwm1_enable`은 read-only PWM mode입니다.

`temp1_input`은 PSU VRM component temperature, `temp1_crit`은 그 maximum critical value입니다. `temp2_input`은 PSU case temperature, `temp2_crit`은 case maximum critical value입니다. 원문의 `cirtical`은 critical의 오타입니다.

Sysfs entries
-------------

=======================        ========================================================
curr1_input                Total current usage
curr2_input                Current on the 12v psu rail
curr2_crit                Current max critical value on the 12v psu rail
curr3_input                Current on the 5v psu rail
curr3_crit                Current max critical value on the 5v psu rail
curr4_input                Current on the 3.3v psu rail
curr4_crit                Current max critical value on the 3.3v psu rail
fan1_input                RPM of psu fan
in0_input                Voltage of the psu ac input
in1_input                Voltage of the 12v psu rail
in1_crit                Voltage max critical value on the 12v psu rail
in1_lcrit                Voltage min critical value on the 12v psu rail
in2_input                Voltage of the 5v psu rail
in2_crit                Voltage max critical value on the 5v psu rail
in2_lcrit                Voltage min critical value on the 5v psu rail
in3_input                Voltage of the 3.3v psu rail
in3_crit                Voltage max critical value on the 3.3v psu rail
in3_lcrit                Voltage min critical value on the 3.3v psu rail
power1_input                Total power usage
power2_input                Power usage of the 12v psu rail
power3_input                Power usage of the 5v psu rail
power4_input                Power usage of the 3.3v psu rail
pwm1                        PWM value, read only
pwm1_enable                PWM mode, read only
temp1_input                Temperature of the psu vrm component
temp1_crit                Temperature max cirtical value of the psu vrm component
temp2_input                Temperature of the psu case
temp2_crit                Temperature max critical value of psu case
=======================        ========================================================

PSU 진단과 debugfs

USB HID device이므로 자동 탐지되고 hot swapping과 여러 장치의 동시 사용을 지원합니다.

Rail voltage level이 flicker하면 PSU failure의 징후일 수 있습니다. Default automatic fan speed plan에서는 정격 wattage의 약 30% load에서 fan이 시작합니다. 그렇지 않으면 fan failure일 가능성이 큽니다.

Hwmon class에 맞지 않는 추가 값은 debugfs로 제공합니다. `ocpmode`는 PCIe power connector의 single/multi rail mode, `product`는 PSU product name, `uptime`은 session uptime, `uptime_total`은 total uptime, `vendor`는 vendor name입니다.

Usage Notes
-----------

It is an USB HID device, so it is auto-detected, supports hot-swapping and
several devices at once.

Flickering values in the rail voltage levels can be an indicator for a failing
PSU. Accordingly to the default automatic fan speed plan the fan starts at about
30% of the wattage rating. If this does not happen, a fan failure is likely. The
driver also provides some additional useful values via debugfs, which do not fit
into the hwmon class.

Debugfs entries
---------------

=======================        ========================================================
ocpmode                 Single or multi rail mode of the PCIe power connectors
product                 Product name of the psu
uptime                        Session uptime of the psu
uptime_total                Total uptime of the psu
vendor                        Vendor name of the psu
=======================        ========================================================