← Documents Documentation/hwmon/gsc-hwmon.rst GitHub 원문 ↗

Linux 6.18.37 · Hardware Monitoring

Kernel driver gsc-hwmon

Gateworks GSC의 완전 scaling된 ADC·temperature와 6-point PWM입니다.

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

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

1. 요약·해설

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

요약·해설

gsc-hwmon.rst:1-53

Version·firmware별 scaling을 driver가 흡수하고 6개 온도 경계로 fan을 제어합니다.

문서 개요
항목
SourceDocumentation/hwmon/gsc-hwmon.rst
분량53 source lines
PWM points6
Output0..255

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

핵심 흐름
ADC 읽기Scaling 적용Label 게시6-point PWM 제어

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

2. 영어 원문 전체

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

원문 전체 펼치기
1 .. SPDX-License-Identifier: GPL-2.0
2
3 Kernel driver gsc-hwmon
4 =======================
5
6 Supported chips: Gateworks GSC
7 Datasheet: http://trac.gateworks.com/wiki/gsc
8 Author: Tim Harvey <tharvey@gateworks.com>
9
10 Description:
11 ------------
12
13 This driver supports hardware monitoring for the temperature sensor,
14 various ADC's connected to the GSC, and optional FAN controller available
15 on some boards.
16
17
18 Voltage Monitoring
19 ------------------
20
21 The voltage inputs are scaled either internally or by the driver depending
22 on the GSC version and firmware. The values returned by the driver do not need
23 further scaling. The voltage input labels provide the voltage rail name:
24
25 inX_input Measured voltage (mV).
26 inX_label Name of voltage rail.
27
28
29 Temperature Monitoring
30 ----------------------
31
32 Temperatures are measured with 12-bit or 10-bit resolution and are scaled
33 either internally or by the driver depending on the GSC version and firmware.
34 The values returned by the driver reflect millidegree Celsius:
35
36 tempX_input Measured temperature.
37 tempX_label Name of temperature input.
38
39
40 PWM Output Control
41 ------------------
42
43 The GSC features 1 PWM output that operates in automatic mode where the
44 PWM value will be scaled depending on 6 temperature boundaries.
45 The tempeature boundaries are read-write and in millidegree Celsius and the
46 read-only PWM values range from 0 (off) to 255 (full speed).
47 Fan speed will be set to minimum (off) when the temperature sensor reads
48 less than pwm1_auto_point1_temp and maximum when the temperature sensor
49 equals or exceeds pwm1_auto_point6_temp.
50
51 pwm1_auto_point[1-6]_pwm PWM value.
52 pwm1_auto_point[1-6]_temp Temperature boundary.
53
54

3. 한국어 전문 번역

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

Gateworks GSC 지원 범위

1-17

GPL-2.0 드라이버 `gsc-hwmon`은 Gateworks GSC의 temperature sensor, GSC에 연결된 여러 ADC, 일부 board의 optional fan controller를 지원합니다. Datasheet는 `http://trac.gateworks.com/wiki/gsc`에 있고 저자는 Tim Harvey입니다.

GSC monitoring
기능지원
Temperature sensor지원
External ADC여러 channel
Fan controller일부 board에서 선택적

Board와 firmware에 따라 제공되는 기능입니다.

GSC 등록
GSC 식별Version·firmware 확인ADC·temperature 등록Optional fan controller 등록

Firmware version과 board 기능에 맞춰 channel을 엽니다.

.. SPDX-License-Identifier: GPL-2.0

Kernel driver gsc-hwmon
=======================

Supported chips: Gateworks GSC
Datasheet: http://trac.gateworks.com/wiki/gsc
Author: Tim Harvey <tharvey@gateworks.com>

Description:
------------

This driver supports hardware monitoring for the temperature sensor,
various ADC's connected to the GSC, and optional FAN controller available
on some boards.

전압·온도 scaling

18-39

Voltage input은 GSC version과 firmware에 따라 내부 또는 driver에서 scaling됩니다. 드라이버 반환값은 추가 scaling이 필요 없습니다. `inX_input`은 mV 단위 measured voltage이고 `inX_label`은 voltage rail 이름입니다.

Temperature는 12-bit 또는 10-bit resolution으로 측정되고 GSC version·firmware에 따라 내부 또는 driver에서 scaling됩니다. 반환값은 millidegree Celsius입니다. `tempX_input`은 measured temperature, `tempX_label`은 temperature input 이름입니다.

GSC sensor ABI
Attribute단위의미
inX_inputmV측정 voltage
inX_labelTextVoltage rail name
tempX_inputmillidegree C측정 temperature
tempX_labelTextTemperature input name
Temperature ADC10 또는 12 bitVersion·firmware 의존

Driver가 완전히 scaling한 값을 label과 함께 제공합니다.

Scaling 경로
Raw ADC 측정GSC version 확인Firmware·driver scaling 선택최종 mV·mC 값 생성Label과 함께 게시

Hardware 또는 driver 중 한 곳에서 보정된 최종 값을 반환합니다.

Voltage Monitoring
------------------

The voltage inputs are scaled either internally or by the driver depending
on the GSC version and firmware. The values returned by the driver do not need
further scaling. The voltage input labels provide the voltage rail name:

inX_input                  Measured voltage (mV).
inX_label                  Name of voltage rail.


Temperature Monitoring
----------------------

Temperatures are measured with 12-bit or 10-bit resolution and are scaled
either internally or by the driver depending on the GSC version and firmware.
The values returned by the driver reflect millidegree Celsius:

tempX_input                Measured temperature.
tempX_label                Name of temperature input.

6단계 automatic PWM

40-53

GSC에는 automatic mode로 동작하는 PWM output 1개가 있고 6개 temperature boundary에 따라 PWM 값을 scaling합니다. Temperature boundary는 millidegree Celsius 단위 읽기·쓰기 값이고 PWM 값은 읽기 전용 0(off)~255(full speed)입니다.

Temperature sensor 값이 `pwm1_auto_point1_temp`보다 낮으면 fan speed는 minimum off가 되고, `pwm1_auto_point6_temp` 이상이면 maximum이 됩니다. `pwm1_auto_point[1-6]_pwm`은 PWM 값, `pwm1_auto_point[1-6]_temp`는 temperature boundary입니다.

GSC automatic curve
Attribute권한·단위범위
pwm1_auto_point[1-6]_tempRW, millidegree CTemperature boundary
pwm1_auto_point[1-6]_pwmRO0..255
Below point1-PWM 0, off
At/above point6-PWM 255, full speed

6개 온도 경계에서 PWM curve를 형성합니다.

6-point PWM scaling
Temperature 읽기Point 1~6 경계 비교해당 구간 PWM scaling0~255 output 적용경계 변경 시 curve 갱신

현재 온도를 경계 구간에 mapping해 output을 정합니다.

PWM Output Control
------------------

The GSC features 1 PWM output that operates in automatic mode where the
PWM value will be scaled depending on 6 temperature boundaries.
The tempeature boundaries are read-write and in millidegree Celsius and the
read-only PWM values range from 0 (off) to 255 (full speed).
Fan speed will be set to minimum (off) when the temperature sensor reads
less than pwm1_auto_point1_temp and maximum when the temperature sensor
equals or exceeds pwm1_auto_point6_temp.

pwm1_auto_point[1-6]_pwm       PWM value.
pwm1_auto_point[1-6]_temp      Temperature boundary.