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

Linux 6.18.37 · Hardware Monitoring

Kernel driver sht15

Sensirion SHT1x·SHT7x의 GPIO 온습도 측정, OTP 보정, CRC 복구, 히터를 지원합니다.

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

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

1. 요약·해설

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

요약·해설

sht15.rst:1-83

두 GPIO로 온습도를 측정하고 해상도·OTP 재적재·CRC 검증을 선택하며 2.47 V 저전압 오류를 보고합니다.

문서 개요
항목
SourceDocumentation/hwmon/sht15.rst
분량83 source lines
고해상도온도 14비트·습도 12비트
통신GPIO 2개

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

운영 흐름
모델·GPIO 확인플랫폼 옵션 설정온습도 측정CRC 검증히터·저전압 확인

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

2. 영어 원문 전체

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

원문 전체 펼치기
1 Kernel driver sht15
2 ===================
3
4 Authors:
5
6 * Wouter Horre
7 * Jonathan Cameron
8 * Vivien Didelot <[email protected]>
9 * Jerome Oufella <[email protected]>
10
11 Supported chips:
12
13 * Sensirion SHT10
14
15 Prefix: 'sht10'
16
17 * Sensirion SHT11
18
19 Prefix: 'sht11'
20
21 * Sensirion SHT15
22
23 Prefix: 'sht15'
24
25 * Sensirion SHT71
26
27 Prefix: 'sht71'
28
29 * Sensirion SHT75
30
31 Prefix: 'sht75'
32
33 Datasheet: Publicly available at the Sensirion website
34
35 http://www.sensirion.ch/en/pdf/product_information/Datasheet-humidity-sensor-SHT1x.pdf
36
37 Description
38 -----------
39
40 The SHT10, SHT11, SHT15, SHT71, and SHT75 are humidity and temperature
41 sensors.
42
43 The devices communicate using two GPIO lines.
44
45 Supported resolutions for the measurements are 14 bits for temperature and 12
46 bits for humidity, or 12 bits for temperature and 8 bits for humidity.
47
48 The humidity calibration coefficients are programmed into an OTP memory on the
49 chip. These coefficients are used to internally calibrate the signals from the
50 sensors. Disabling the reload of those coefficients allows saving 10ms for each
51 measurement and decrease power consumption, while losing on precision.
52
53 Some options may be set via sysfs attributes.
54
55 Notes:
56 * The regulator supply name is set to "vcc".
57 * If a CRC validation fails, a soft reset command is sent, which resets
58 status register to its hardware default value, but the driver will try to
59 restore the previous device configuration.
60
61 Platform data
62 -------------
63
64 * checksum:
65 set it to true to enable CRC validation of the readings (default to false).
66 * no_otp_reload:
67 flag to indicate not to reload from OTP (default to false).
68 * low_resolution:
69 flag to indicate the temp/humidity resolution to use (default to false).
70
71 Sysfs interface
72 ---------------
73
74 ================== ==========================================================
75 temp1_input temperature input
76 humidity1_input humidity input
77 heater_enable write 1 in this attribute to enable the on-chip heater,
78 0 to disable it. Be careful not to enable the heater
79 for too long.
80 temp1_fault if 1, this means that the voltage is low (below 2.47V) and
81 measurement may be invalid.
82 humidity1_fault same as temp1_fault.
83 ================== ==========================================================
84

3. 한국어 전문 번역

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

Sensirion SHT1x·SHT7x 지원 모델

1-36

`sht15` 드라이버는 Sensirion SHT10, SHT11, SHT15, SHT71, SHT75 온습도 센서를 지원합니다. 각 접두사는 모델명과 같은 `sht10`, `sht11`, `sht15`, `sht71`, `sht75`입니다.

작성자는 Wouter Horre, Jonathan Cameron, Vivien Didelot, Jerome Oufella입니다. 데이터시트는 Sensirion 웹사이트에 공개되어 있으며 문서에 SHT1x 제품군 자료 링크가 제공됩니다.

SHT15 드라이버 지원 칩
제조사모델접두사
SensirionSHT10sht10
SensirionSHT11sht11
SensirionSHT15sht15
SensirionSHT71sht71
SensirionSHT75sht75

지원 모델과 장치 등록에 사용하는 접두사입니다.

SHT1x 장치 선택
센서 모델 확인모델별 sht 접두사 선택데이터·클록 GPIO 배선 확인플랫폼 데이터 옵션 결정온도·습도 채널 등록

실장 모델에 맞는 접두사를 선택해 두 GPIO 통신 장치를 구성합니다.

Kernel driver sht15
===================

Authors:

  * Wouter Horre
  * Jonathan Cameron
  * Vivien Didelot <[email protected]>
  * Jerome Oufella <[email protected]>

Supported chips:

  * Sensirion SHT10

    Prefix: 'sht10'

  * Sensirion SHT11

    Prefix: 'sht11'

  * Sensirion SHT15

    Prefix: 'sht15'

  * Sensirion SHT71

    Prefix: 'sht71'

  * Sensirion SHT75

    Prefix: 'sht75'

Datasheet: Publicly available at the Sensirion website

        http://www.sensirion.ch/en/pdf/product_information/Datasheet-humidity-sensor-SHT1x.pdf

GPIO 통신·해상도·OTP 보정

37-60

SHT10, SHT11, SHT15, SHT71, SHT75는 온도와 습도를 함께 측정하며 두 개의 GPIO 라인으로 통신합니다.

고해상도 조합은 온도 14비트·습도 12비트이고, 저해상도 조합은 온도 12비트·습도 8비트입니다.

습도 보정 계수는 칩의 OTP 메모리에 기록되어 센서 신호의 내부 보정에 사용됩니다. 계수 재적재를 끄면 측정마다 10 ms를 절약하고 전력 소비를 낮출 수 있지만 정밀도가 떨어집니다.

레귤레이터 공급 이름은 `vcc`입니다. CRC 검증이 실패하면 소프트 리셋 명령을 보내 상태 레지스터를 하드웨어 기본값으로 되돌린 뒤 드라이버가 이전 장치 구성을 복원하려고 시도합니다.

SHT15 측정·복구 특성
항목설정·동작영향
고해상도온도 14비트, 습도 12비트높은 정밀도
저해상도온도 12비트, 습도 8비트빠른 측정
OTP 재적재 사용보정 계수 매 측정 반영정밀도 유지
OTP 재적재 안 함측정당 10 ms 절약전력 감소, 정밀도 저하
CRC 실패소프트 리셋 후 구성 복원 시도상태 레지스터 기본값 복귀

해상도 조합과 OTP·CRC 동작의 절충점을 정리합니다.

SHT15 측정 처리
두 GPIO로 측정 명령 전송선택한 해상도로 온도·습도 변환필요하면 OTP 보정 계수 재적재CRC 사용 시 응답 검증실패 시 소프트 리셋과 이전 구성 복원

GPIO 측정과 선택적 CRC 검증을 거쳐 보정 값을 제공합니다.

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

The SHT10, SHT11, SHT15, SHT71, and SHT75 are humidity and temperature
sensors.

The devices communicate using two GPIO lines.

Supported resolutions for the measurements are 14 bits for temperature and 12
bits for humidity, or 12 bits for temperature and 8 bits for humidity.

The humidity calibration coefficients are programmed into an OTP memory on the
chip. These coefficients are used to internally calibrate the signals from the
sensors. Disabling the reload of those coefficients allows saving 10ms for each
measurement and decrease power consumption, while losing on precision.

Some options may be set via sysfs attributes.

Notes:
  * The regulator supply name is set to "vcc".
  * If a CRC validation fails, a soft reset command is sent, which resets
    status register to its hardware default value, but the driver will try to
    restore the previous device configuration.

플랫폼 옵션과 히터·저전압 경보

61-83

플랫폼 데이터의 `checksum`을 true로 설정하면 측정값 CRC 검증을 사용하며 기본값은 false입니다. `no_otp_reload`는 OTP 재적재를 하지 않도록 하는 플래그, `low_resolution`은 낮은 온도·습도 해상도를 선택하는 플래그이며 둘 다 기본값은 false입니다.

`temp1_input`과 `humidity1_input`은 각각 온도와 습도를 제공합니다. `heater_enable`에 1을 쓰면 칩 내장 히터가 켜지고 0을 쓰면 꺼집니다. 히터를 너무 오래 켜 두지 않도록 주의해야 합니다.

`temp1_fault`가 1이면 공급 전압이 2.47 V 아래로 낮아 측정값이 유효하지 않을 수 있음을 뜻합니다. `humidity1_fault`도 같은 저전압 상태를 나타냅니다.

SHT15 옵션과 sysfs
이름기본·범위의미
checksumfalsetrue이면 CRC 검증
no_otp_reloadfalsetrue이면 OTP 계수 재적재 안 함
low_resolutionfalsetrue이면 12비트 온도·8비트 습도
temp1_inputRO온도 입력
humidity1_inputRO습도 입력
heater_enable0 또는 1내장 히터 끄기·켜기
temp1_fault0 또는 11이면 전압 2.47 V 미만
humidity1_fault0 또는 1temp1_fault와 같은 저전압 상태

플랫폼 플래그의 기본값과 사용자 공간 속성을 함께 표시합니다.

SHT15 운영 설정
CRC 필요 여부로 checksum 설정속도·전력과 정밀도를 비교해 OTP 재적재 결정해상도 플래그 선택온도·습도 측정값 판독히터 사용 시간과 2.47 V 저전압 경보 확인

정밀도·전력·무결성 요구에 맞춰 플랫폼 옵션과 히터를 선택합니다.

Platform data
-------------

* checksum:
  set it to true to enable CRC validation of the readings (default to false).
* no_otp_reload:
  flag to indicate not to reload from OTP (default to false).
* low_resolution:
  flag to indicate the temp/humidity resolution to use (default to false).

Sysfs interface
---------------

================== ==========================================================
temp1_input        temperature input
humidity1_input    humidity input
heater_enable      write 1 in this attribute to enable the on-chip heater,
                   0 to disable it. Be careful not to enable the heater
                   for too long.
temp1_fault        if 1, this means that the voltage is low (below 2.47V) and
                   measurement may be invalid.
humidity1_fault    same as temp1_fault.
================== ==========================================================