Kernel driver shtc1 | Linux 6.18.37

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

1. 요약·해설

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

요약·해설

shtc1.rst:1-67

주소 0x70의 센서를 등록하고 기본 비차단·고정확도 모드 또는 클록 스트레칭 차단 모드로 온습도를 읽습니다.

문서 개요

항목값

SourceDocumentation/hwmon/shtc1.rst

분량67 source lines

주소0x70

기본값비차단·고정확도

원문 분량과 핵심 장치 구성을 정리합니다.

운영 흐름

모델 등록클록 스트레칭 확인차단 모드 선택정확도 선택온습도 판독

장치 식별부터 측정값 확인까지의 핵심 순서입니다.

2. 영어 원문 전체

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

원문 전체 펼치기

1 Kernel driver shtc1

2 ===================

4 Supported chips:

6 * Sensirion SHTC1

8 Prefix: 'shtc1'

10 Addresses scanned: none

12 Datasheet: https://www.sensirion.com/file/datasheet_shtc1

16 * Sensirion SHTW1

18 Prefix: 'shtw1'

20 Addresses scanned: none

22 Datasheet: https://www.sensirion.com/file/datasheet_shtw1

26 * Sensirion SHTC3

28 Prefix: 'shtc3'

30 Addresses scanned: none

32 Datasheet: https://www.sensirion.com/file/datasheet_shtc3

36 Author:

38 Johannes Winkelmann <johannes.winkelmann@sensirion.com>

40 Description

41 -----------

43 This driver implements support for the Sensirion SHTC1, SHTW1, and SHTC3

44 chips, a humidity and temperature sensor. Temperature is measured in degrees

45 celsius, relative humidity is expressed as a percentage.

47 The device communicates with the I2C protocol. All sensors are set to I2C

48 address 0x70. See Documentation/i2c/instantiating-devices.rst for methods to

49 instantiate the device.

51 There are two options configurable by means of shtc1_platform_data:

53 1. blocking (pull the I2C clock line down while performing the measurement) or

54 non-blocking mode. Blocking mode will guarantee the fastest result but

55 the I2C bus will be busy during that time. By default, non-blocking mode

56 is used. Make sure clock-stretching works properly on your device if you

57 want to use blocking mode.

58 2. high or low accuracy. High accuracy is used by default and using it is

59 strongly recommended.

61 sysfs-Interface

62 ---------------

64 temp1_input

65 - temperature input

66 humidity1_input

67 - humidity input

3. 한국어 전문 번역

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

Sensirion SHTC1·SHTW1·SHTC3

1-39

`shtc1` 드라이버는 Sensirion SHTC1, SHTW1, SHTC3 온습도 센서를 지원합니다. 각 접두사는 `shtc1`, `shtw1`, `shtc3`이며 주소 자동 검색은 하지 않습니다. 각 모델의 데이터시트 링크가 문서에 제공됩니다.

문서 작성자는 Johannes Winkelmann입니다.

shtc1 드라이버 지원 모델

모델접두사주소 검색데이터시트

SHTC1shtc1없음공개

SHTW1shtw1없음공개

SHTC3shtc3없음공개

지원 칩과 장치 등록 접두사를 대응시킵니다.

SHTC 계열 등록

SHTC1·SHTW1·SHTC3 모델 확인모델별 접두사 선택I2C 버스 확인주소 0x70에 장치 등록온도·습도 채널 확인

모델 접두사와 공통 I2C 주소로 센서를 생성합니다.

Kernel driver shtc1
===================

Supported chips:

  * Sensirion SHTC1

    Prefix: 'shtc1'

    Addresses scanned: none

    Datasheet: https://www.sensirion.com/file/datasheet_shtc1



  * Sensirion SHTW1

    Prefix: 'shtw1'

    Addresses scanned: none

    Datasheet: https://www.sensirion.com/file/datasheet_shtw1



  * Sensirion SHTC3

    Prefix: 'shtc3'

    Addresses scanned: none

    Datasheet: https://www.sensirion.com/file/datasheet_shtc3



Author:

  Johannes Winkelmann <johannes.winkelmann@sensirion.com>

차단 모드와 정확도 플랫폼 옵션

40-60

이 드라이버는 SHTC1, SHTW1, SHTC3 온습도 센서를 지원합니다. 온도는 섭씨, 상대 습도는 백분율로 표현됩니다. 모든 센서는 I2C 주소 `0x70`을 사용하며 장치 생성 방법은 `Documentation/i2c/instantiating-devices.rst`를 참고합니다.

`shtc1_platform_data`에서 두 가지를 설정할 수 있습니다. 첫째는 차단 또는 비차단 측정입니다. 차단 모드는 측정 중 I2C 클록 라인을 low로 당겨 가장 빠른 결과를 보장하지만 그동안 버스가 점유됩니다. 기본값은 비차단 모드입니다. 차단 모드를 사용하려면 컨트롤러의 클록 스트레칭이 제대로 동작하는지 확인해야 합니다.

둘째는 높거나 낮은 정확도입니다. 기본값은 높은 정확도이며 문서도 높은 정확도 사용을 강하게 권장합니다.

SHTC1 플랫폼 옵션

옵션선택기본값·영향

blocking차단가장 빠른 결과, 측정 중 I2C 버스 점유, 클록 스트레칭 필요

blocking비차단기본값, 측정 중 버스 사용 가능

accuracy높음기본값, 강력 권장

accuracy낮음낮은 정확도

측정 중 버스 점유와 정확도의 선택지를 정리합니다.

SHTC 측정 모드 선택

클록 스트레칭 지원 확인차단·비차단 모드 선택정확도 요구 확인기본 높은 정확도 유지 여부 결정선택한 옵션으로 측정 수행

I2C 컨트롤러 능력과 측정 품질 요구에 맞춰 플랫폼 데이터를 설정합니다.

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

This driver implements support for the Sensirion SHTC1, SHTW1, and SHTC3
chips, a humidity and temperature sensor. Temperature is measured in degrees
celsius, relative humidity is expressed as a percentage.

The device communicates with the I2C protocol. All sensors are set to I2C
address 0x70. See Documentation/i2c/instantiating-devices.rst for methods to
instantiate the device.

There are two options configurable by means of shtc1_platform_data:

1. blocking (pull the I2C clock line down while performing the measurement) or
   non-blocking mode. Blocking mode will guarantee the fastest result but
   the I2C bus will be busy during that time. By default, non-blocking mode
   is used. Make sure clock-stretching works properly on your device if you
   want to use blocking mode.
2. high or low accuracy. High accuracy is used by default and using it is
   strongly recommended.

온도와 습도 입력

61-67

sysfs의 `temp1_input`은 온도 입력을, `humidity1_input`은 습도 입력을 제공합니다.

SHTC1 sysfs 속성

속성의미

temp1_input온도 입력

humidity1_input습도 입력

센서가 제공하는 두 표준 측정 채널입니다.

SHTC1 측정값 읽기

온도·습도 측정 시작차단 또는 비차단 완료 대기선택한 정확도로 결과 수신temp1_input 갱신humidity1_input 갱신

선택한 모드로 변환한 뒤 두 hwmon 채널을 갱신합니다.

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

temp1_input
        - temperature input
humidity1_input
        - humidity input