Kernel driver ChipCap2 | Linux 6.18.37

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

1. 요약·해설

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

요약·해설

chipcap2.rst:1-73

온도와 상대습도를 14-bit로 측정하고 hardware 구성에 따라 humidity limit·hysteresis를 제공합니다.

문서 개요

항목값

SourceDocumentation/hwmon/chipcap2.rst

분량73 source lines

Humidity0~100000 pcm

Temperature-40000~125000 mC

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

핵심 흐름

I2C 0x28 장치 등록온습도 sample 읽기Threshold 양자화Optional alarm 게시

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

2. 영어 원문 전체

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

원문 전체 펼치기

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

3 Kernel driver ChipCap2

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

6 Supported chips:

8 * Amphenol CC2D23, CC2D23S, CC2D25, CC2D25S, CC2D33, CC2D33S, CC2D35, CC2D35S

10 Prefix: 'chipcap2'

12 Addresses scanned: -

14 Datasheet: https://www.amphenol-sensors.com/en/telaire/humidity/527-humidity-sensors/3095-chipcap-2

16 Author:

18 - Javier Carrasco <javier.carrasco.cruz@gmail.com>

20 Description

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

23 This driver implements support for the Amphenol ChipCap 2, a humidity and

24 temperature chip family. Temperature is measured in milli degrees celsius,

25 relative humidity is expressed as a per cent mille. The measurement ranges

26 are the following:

28 - Relative humidity: 0 to 100000 pcm (14-bit resolution)

29 - Temperature: -40000 to +125000 m°C (14-bit resolution)

31 The device communicates with the I2C protocol and uses the I2C address 0x28

32 by default.

34 Depending on the hardware configuration, up to two humidity alarms to control

35 minimum and maximum values are provided. Their thresholds and hystersis can be

36 configured via sysfs.

38 Thresholds and hysteris must be provided as a per cent mille. These values

39 might be truncated to match the 14-bit device resolution (6.1 pcm/LSB)

41 Known Issues

42 ------------

44 The driver does not support I2C address and command window length modification.

46 sysfs-Interface

47 ---------------

49 The following list includes the sysfs attributes that the driver always provides,

50 their permissions and a short description:

52 =============================== ======= ========================================

53 Name Perm Description

54 =============================== ======= ========================================

55 temp1_input: RO temperature input

56 humidity1_input: RO humidity input

57 =============================== ======= ========================================

59 The following list includes the sysfs attributes that the driver may provide

60 depending on the hardware configuration:

62 =============================== ======= ========================================

63 Name Perm Description

64 =============================== ======= ========================================

65 humidity1_min: RW humidity low limit. Measurements under

66 this limit trigger a humidity low alarm

67 humidity1_max: RW humidity high limit. Measurements above

68 this limit trigger a humidity high alarm

69 humidity1_min_hyst: RW humidity low hystersis

70 humidity1_max_hyst: RW humidity high hystersis

71 humidity1_min_alarm: RO humidity low alarm indicator

72 humidity1_max_alarm: RO humidity high alarm indicator

73 =============================== ======= ========================================

3. 한국어 전문 번역

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

ChipCap 2 온습도 측정

1-40

이 GPL-2.0-or-later driver는 Amphenol `CC2D23`, `CC2D23S`, `CC2D25`, `CC2D25S`, `CC2D33`, `CC2D33S`, `CC2D35`, `CC2D35S`를 prefix `chipcap2`로 지원합니다. 주소는 검색하지 않으며 datasheet URL이 제공됩니다. 저자는 Javier Carrasco입니다.

ChipCap 2는 humidity와 temperature chip family입니다. Temperature는 milli degrees Celsius, relative humidity는 per cent mille, 즉 pcm으로 표현합니다.

Relative humidity 범위는 `0`~`100000 pcm`, temperature 범위는 `-40000`~`+125000 mC`이며 둘 다 14-bit resolution입니다. 장치는 I2C protocol을 사용하고 default address는 `0x28`입니다.

Hardware configuration에 따라 minimum과 maximum을 제어하는 humidity alarm을 최대 2개 제공합니다. Threshold와 hysteresis는 sysfs에서 설정합니다. 값은 pcm 단위로 제공해야 하며 14-bit device resolution인 `6.1 pcm/LSB`에 맞추기 위해 잘릴 수 있습니다.

ChipCap 2 측정 범위

항목범위해상도/단위

Relative humidity0~10000014 bit, pcm

Temperature-40000~+12500014 bit, milli degrees Celsius

I2C address0x28 default자동 검색 없음

Humidity thresholdHardware에 따라 min/max6.1 pcm/LSB로 양자화

온도·습도 범위와 해상도입니다.

Humidity alarm 계산

Humidity threshold를 pcm으로 받기6.1 pcm/LSB 단위로 truncateMinimum·maximum register 설정Humidity 측정값과 비교Low 또는 high alarm 게시

Sysfs pcm 값을 14-bit hardware threshold로 변환합니다.

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

Kernel driver ChipCap2
======================

Supported chips:

  * Amphenol CC2D23, CC2D23S, CC2D25, CC2D25S, CC2D33, CC2D33S, CC2D35, CC2D35S

    Prefix: 'chipcap2'

    Addresses scanned: -

    Datasheet: https://www.amphenol-sensors.com/en/telaire/humidity/527-humidity-sensors/3095-chipcap-2

Author:

  - Javier Carrasco <javier.carrasco.cruz@gmail.com>

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

This driver implements support for the Amphenol ChipCap 2, a humidity and
temperature chip family. Temperature is measured in milli degrees celsius,
relative humidity is expressed as a per cent mille. The measurement ranges
are the following:

  - Relative humidity: 0 to 100000 pcm (14-bit resolution)
  - Temperature: -40000 to +125000 m°C (14-bit resolution)

The device communicates with the I2C protocol and uses the I2C address 0x28
by default.

Depending on the hardware configuration, up to two humidity alarms to control
minimum and maximum values are provided. Their thresholds and hystersis can be
configured via sysfs.

Thresholds and hysteris must be provided as a per cent mille. These values
might be truncated to match the 14-bit device resolution (6.1 pcm/LSB)

ChipCap 2 알려진 제한과 sysfs

41-73

Driver는 I2C address 변경과 command window length 변경을 지원하지 않습니다.

항상 제공되는 read-only attribute는 temperature input인 `temp1_input`과 humidity input인 `humidity1_input`입니다.

Hardware configuration에 따라 read/write `humidity1_min`과 `humidity1_max`를 제공합니다. 측정값이 min 아래면 humidity low alarm, max 위면 humidity high alarm이 발생합니다.

Read/write `humidity1_min_hyst`, `humidity1_max_hyst`는 low·high hysteresis입니다. Read-only `humidity1_min_alarm`, `humidity1_max_alarm`은 low·high alarm indicator입니다.

ChipCap 2 ABI

Attribute권한가용성

temp1_inputRO항상

humidity1_inputRO항상

humidity1_min/maxRWHardware alarm 구성 시

humidity1_min/max_hystRWHardware alarm 구성 시

humidity1_min/max_alarmROHardware alarm 구성 시

항상 존재하는 input과 선택적인 alarm attribute입니다.

Sysfs capability 결정

ChipCap 2 configuration 읽기Temperature·humidity input 항상 등록Alarm hardware 존재 여부 확인있으면 limit·hysteresis·alarm 등록Address와 command window는 변경하지 않음

Hardware alarm 구성 여부에 따라 optional entry를 만듭니다.

Known Issues
------------

The driver does not support I2C address and command window length modification.

sysfs-Interface
---------------

The following list includes the sysfs attributes that the driver always provides,
their permissions and a short description:

=============================== ======= ========================================
Name                            Perm    Description
=============================== ======= ========================================
temp1_input:                    RO      temperature input
humidity1_input:                RO      humidity input
=============================== ======= ========================================

The following list includes the sysfs attributes that the driver may provide
depending on the hardware configuration:

=============================== ======= ========================================
Name                            Perm    Description
=============================== ======= ========================================
humidity1_min:                  RW      humidity low limit. Measurements under
                                        this limit trigger a humidity low alarm
humidity1_max:                  RW      humidity high limit. Measurements above
                                        this limit trigger a humidity high alarm
humidity1_min_hyst:             RW      humidity low hystersis
humidity1_max_hyst:             RW      humidity high hystersis
humidity1_min_alarm:            RO      humidity low alarm indicator
humidity1_max_alarm:            RO      humidity high alarm indicator
=============================== ======= ========================================