← Documents Documentation/hwmon/gigabyte_waterforce.rst GitHub 원문 ↗

Linux 6.18.37 · Hardware Monitoring

Kernel driver gigabyte_waterforce

Gigabyte Waterforce AIO의 fan·pump RPM과 coolant temperature입니다.

Source pathDocumentation/hwmon/gigabyte_waterforce.rst
Source versionLinux v6.18.37
TranslationDUJINLABS 전문 번역 + 해설

요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.

1. 요약·해설

원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.

요약·해설

gigabyte_waterforce.rst:1-47

USB hot-swap cooler의 핵심 sensor와 debugfs firmware 정보를 제공합니다.

문서 개요
항목
SourceDocumentation/hwmon/gigabyte_waterforce.rst
분량47 source lines
ModelX240·X280·X360
TransportUSB HID

원문 분량과 핵심 범위입니다.

핵심 흐름
USB 연결Sensor 자동 등록Cooling 값 읽기분리 처리

장치 동작의 기본 순서입니다.

2. 영어 원문 전체

번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.

원문 전체 펼치기
1 .. SPDX-License-Identifier: GPL-2.0-or-later
2
3 Kernel driver gigabyte_waterforce
4 =================================
5
6 Supported devices:
7
8 * Gigabyte AORUS WATERFORCE X240
9 * Gigabyte AORUS WATERFORCE X280
10 * Gigabyte AORUS WATERFORCE X360
11
12 Author: Aleksa Savic
13
14 Description
15 -----------
16
17 This driver enables hardware monitoring support for the listed Gigabyte Waterforce
18 all-in-one CPU liquid coolers. Available sensors are pump and fan speed in RPM, as
19 well as coolant temperature. Also available through debugfs is the firmware version.
20
21 Attaching a fan is optional and allows it to be controlled from the device. If
22 it's not connected, the fan-related sensors will report zeroes.
23
24 The addressable RGB LEDs and LCD screen are not supported in this driver and should
25 be controlled through userspace tools.
26
27 Usage notes
28 -----------
29
30 As these are USB HIDs, the driver can be loaded automatically by the kernel and
31 supports hot swapping.
32
33 Sysfs entries
34 -------------
35
36 =========== =============================================
37 fan1_input Fan speed (in rpm)
38 fan2_input Pump speed (in rpm)
39 temp1_input Coolant temperature (in millidegrees Celsius)
40 =========== =============================================
41
42 Debugfs entries
43 ---------------
44
45 ================ =======================
46 firmware_version Device firmware version
47 ================ =======================
48

3. 한국어 전문 번역

영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.

AORUS WATERFORCE 지원 장치

1-15

GPL-2.0-or-later 드라이버 `gigabyte_waterforce`는 Gigabyte AORUS WATERFORCE X240, X280, X360 all-in-one CPU liquid cooler를 지원합니다. 저자는 Aleksa Savic입니다.

Waterforce 지원표
Model종류
AORUS WATERFORCE X240AIO CPU liquid cooler
AORUS WATERFORCE X280AIO CPU liquid cooler
AORUS WATERFORCE X360AIO CPU liquid cooler

Radiator 크기가 다른 세 AIO model입니다.

Waterforce 등록
USB HID 연결지원 product 식별Kernel driver 자동 loadHwmon·debugfs 등록

USB HID model을 식별해 cooling sensor를 게시합니다.

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

Kernel driver gigabyte_waterforce
=================================

Supported devices:

* Gigabyte AORUS WATERFORCE X240
* Gigabyte AORUS WATERFORCE X280
* Gigabyte AORUS WATERFORCE X360

Author: Aleksa Savic

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

Monitoring 범위와 USB HID 사용

16-32

이 드라이버는 나열된 Gigabyte Waterforce AIO cooler의 hardware monitoring을 제공합니다. Pump와 fan speed를 RPM으로, coolant temperature를 측정하며 firmware version은 debugfs에서 제공합니다.

Fan 연결은 선택 사항이며 연결하면 장치에서 제어할 수 있습니다. 연결하지 않으면 fan 관련 sensor는 0을 보고합니다. Addressable RGB LED와 LCD screen은 드라이버에서 지원하지 않으므로 userspace tool로 제어해야 합니다.

장치가 USB HID이므로 kernel이 driver를 자동으로 load할 수 있고 hot swapping을 지원합니다.

지원 범위
기능지원 위치
Fan RPMhwmon
Pump RPMhwmon
Coolant temperaturehwmon
Firmware versiondebugfs
RGB LED·LCDUserspace tool
Hot swap지원

Kernel monitoring과 userspace 제어 대상을 구분합니다.

Hot-swap 동작
USB HID 연결Driver 자동 bindingSensor 게시Optional fan 상태 반영분리 시 interface 제거

연결 상태에 맞춰 sensor가 생성·제거됩니다.


This driver enables hardware monitoring support for the listed Gigabyte Waterforce
all-in-one CPU liquid coolers. Available sensors are pump and fan speed in RPM, as
well as coolant temperature. Also available through debugfs is the firmware version.

Attaching a fan is optional and allows it to be controlled from the device. If
it's not connected, the fan-related sensors will report zeroes.

The addressable RGB LEDs and LCD screen are not supported in this driver and should
be controlled through userspace tools.

Usage notes
-----------

As these are USB HIDs, the driver can be loaded automatically by the kernel and
supports hot swapping.

Waterforce sysfs·debugfs 표

33-47

Sysfs에서 `fan1_input`은 fan speed RPM, `fan2_input`은 pump speed RPM, `temp1_input`은 millidegrees Celsius 단위 coolant temperature입니다.

Debugfs의 `firmware_version`은 device firmware version을 제공합니다.

Waterforce interface
위치Attribute
sysfsfan1_inputFan speed, RPM
sysfsfan2_inputPump speed, RPM
sysfstemp1_inputCoolant, millidegrees Celsius
debugfsfirmware_versionDevice firmware version

원문의 ASCII 표를 subsystem과 단위별로 구조화했습니다.

Cooling 상태 읽기
fan1_input 읽기fan2_input 읽기temp1_input 읽기필요 시 firmware_version 확인

Fan·pump·coolant 값을 함께 확인합니다.

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

=========== =============================================
fan1_input  Fan speed (in rpm)
fan2_input  Pump speed (in rpm)
temp1_input Coolant temperature (in millidegrees Celsius)
=========== =============================================

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

================ =======================
firmware_version Device firmware version
================ =======================