Kernel driver cgbc-hwmon | Linux 6.18.37

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

1. 요약·해설

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

요약·해설

cgbc-hwmon.rst:1-63

SoM과 system에 실제 존재하는 Board Controller sensor만 표준 channel map에 노출합니다.

문서 개요

항목값

SourceDocumentation/hwmon/cgbc-hwmon.rst

분량63 source lines

Potential inputs10 temp, 14 voltage, 3 current, 6 fan

AvailabilitySystem별 가변

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

핵심 흐름

Capability 조회Sensor 유형 분류Channel mappingSysfs 게시

장치를 측정하는 기본 순서입니다.

2. 영어 원문 전체

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

원문 전체 펼치기

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

3 Kernel driver cgbc-hwmon

4 ========================

6 Supported chips:

8 * Congatec Board Controller.

10 Prefix: 'cgbc-hwmon'

12 Author: Thomas Richard <thomas.richard@bootlin.com>

14 Description

15 -----------

17 This driver enables monitoring support for the Congatec Board Controller.

18 This controller is embedded on the x86 SoMs of Congatec.

20 Sysfs entries

21 -------------

23 The following sysfs entries list contains all sensors defined in the Board

24 Controller. The available sensors in sysfs depend on the SoM and the

25 system.

27 ============= ======================

28 Name Description

29 ============= ======================

30 temp1_input CPU temperature

31 temp2_input Box temperature

32 temp3_input Ambient temperature

33 temp4_input Board temperature

34 temp5_input Carrier temperature

35 temp6_input Chipset temperature

36 temp7_input Video temperature

37 temp8_input Other temperature

38 temp9_input TOPDIM temperature

39 temp10_input BOTTOMDIM temperature

40 in0_input CPU voltage

41 in1_input DC Runtime voltage

42 in2_input DC Standby voltage

43 in3_input CMOS Battery voltage

44 in4_input Battery voltage

45 in5_input AC voltage

46 in6_input Other voltage

47 in7_input 5V voltage

48 in8_input 5V Standby voltage

49 in9_input 3V3 voltage

50 in10_input 3V3 Standby voltage

51 in11_input VCore A voltage

52 in12_input VCore B voltage

53 in13_input 12V voltage

54 curr1_input DC current

55 curr2_input 5V current

56 curr3_input 12V current

57 fan1_input CPU fan

58 fan2_input Box fan

59 fan3_input Ambient fan

60 fan4_input Chiptset fan

61 fan5_input Video fan

62 fan6_input Other fan

63 ============= ======================

3. 한국어 전문 번역

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

Congatec Board Controller 지원

1-25

이 GPL-2.0-or-later driver는 prefix `cgbc-hwmon`의 Congatec Board Controller monitoring을 지원합니다. Controller는 Congatec x86 SoM에 내장되어 있으며 저자는 Thomas Richard입니다.

아래 sysfs 목록은 Board Controller에 정의된 모든 sensor를 보여 줍니다. 실제 sysfs에서 사용할 수 있는 sensor는 SoM과 system 구성에 따라 달라집니다.

CGBC hwmon 특성

항목값

ControllerCongatec Board Controller

PlatformCongatec x86 SoM

Prefixcgbc-hwmon

Sensor availabilitySoM·system에 따라 일부만 노출

Board controller의 위치와 동적 sensor 가용성입니다.

동적 센서 등록

Congatec SoM 식별Board Controller capability 조회사용 가능한 sensor 목록 결정해당 sysfs entry만 생성

Controller capability를 읽어 실제 존재하는 channel만 게시합니다.

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

Kernel driver cgbc-hwmon
========================

Supported chips:

 * Congatec Board Controller.

   Prefix: 'cgbc-hwmon'

Author: Thomas Richard <thomas.richard@bootlin.com>

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

This driver enables monitoring support for the Congatec Board Controller.
This controller is embedded on the x86 SoMs of Congatec.

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

The following sysfs entries list contains all sensors defined in the Board
Controller. The available sensors in sysfs depend on the SoM and the
system.

CGBC temperature·voltage·current·fan

26-63

Temperature channel은 `temp1` CPU, `temp2` Box, `temp3` Ambient, `temp4` Board, `temp5` Carrier, `temp6` Chipset, `temp7` Video, `temp8` Other, `temp9` TOPDIM, `temp10` BOTTOMDIM입니다.

Voltage channel은 `in0` CPU, `in1` DC Runtime, `in2` DC Standby, `in3` CMOS Battery, `in4` Battery, `in5` AC, `in6` Other, `in7` 5V, `in8` 5V Standby, `in9` 3V3, `in10` 3V3 Standby, `in11` VCore A, `in12` VCore B, `in13` 12V입니다.

Current channel은 `curr1` DC, `curr2` 5V, `curr3` 12V입니다. Fan channel은 `fan1` CPU, `fan2` Box, `fan3` Ambient, `fan4` Chipset, `fan5` Video, `fan6` Other fan입니다. 원문의 `Chiptset`은 Chipset을 뜻합니다.

CGBC sensor map

그룹채널대상

Temperaturetemp1~10CPU, Box, Ambient, Board, Carrier, Chipset, Video, Other, TOPDIM, BOTTOMDIM

Voltagein0~6CPU, DC Runtime/Standby, CMOS Battery, Battery, AC, Other

Voltagein7~135V/standby, 3V3/standby, VCore A/B, 12V

Currentcurr1~3DC, 5V, 12V

Fanfan1~6CPU, Box, Ambient, Chipset, Video, Other

모든 잠재 channel을 그룹별로 정리합니다.

CGBC channel 게시

Sensor type 확인Temperature·voltage·current·fan 분류정의된 channel 번호에 mapping존재하는 값만 sysfs에 게시

Firmware가 제공하는 sensor identity를 고정 channel map에 연결합니다.


============= ======================
Name          Description
============= ======================
temp1_input   CPU temperature
temp2_input   Box temperature
temp3_input   Ambient temperature
temp4_input   Board temperature
temp5_input   Carrier temperature
temp6_input   Chipset temperature
temp7_input   Video temperature
temp8_input   Other temperature
temp9_input   TOPDIM temperature
temp10_input  BOTTOMDIM temperature
in0_input     CPU voltage
in1_input     DC Runtime voltage
in2_input     DC Standby voltage
in3_input     CMOS Battery voltage
in4_input     Battery voltage
in5_input     AC voltage
in6_input     Other voltage
in7_input     5V voltage
in8_input     5V Standby voltage
in9_input     3V3 voltage
in10_input    3V3 Standby voltage
in11_input    VCore A voltage
in12_input    VCore B voltage
in13_input    12V voltage
curr1_input   DC current
curr2_input   5V current
curr3_input   12V current
fan1_input    CPU fan
fan2_input    Box fan
fan3_input    Ambient fan
fan4_input    Chiptset fan
fan5_input    Video fan
fan6_input    Other fan
============= ======================