Kernel driver sht3x

SHT3x-DIS·STS3x-DIS 제품군

`sht3x` 드라이버는 Sensirion SHT3x-DIS 온습도 센서와 STS3x-DIS 온도 센서를 지원합니다. 각 접두사는 `sht3x`와 `sts3x`이고 주소 자동 검색은 하지 않습니다.

문서에는 SHT3x-DIS·SHT33과 STS3x·STS32·STS33의 데이터시트 링크가 제공됩니다. 작성자는 David Frey와 Pascal Sachs입니다.

Kernel driver sht3x
===================

Supported chips:

  * Sensirion SHT3x-DIS

    Prefix: 'sht3x'

    Addresses scanned: none

    Datasheets:
        - https://sensirion.com/media/documents/213E6A3B/63A5A569/Datasheet_SHT3x_DIS.pdf
        - https://sensirion.com/media/documents/051DF50B/639C8101/Sensirion_Humidity_and_Temperature_Sensors_Datasheet_SHT33.pdf

  * Sensirion STS3x-DIS

    Prefix: 'sts3x'

    Addresses scanned: none

    Datasheets:
        - https://sensirion.com/media/documents/1DA31AFD/61641F76/Sensirion_Temperature_Sensors_STS3x_Datasheet.pdf
        - https://sensirion.com/media/documents/292A335C/65537BAF/Sensirion_Datasheet_STS32_STS33.pdf

Author:

  - David Frey <[email protected]>
  - Pascal Sachs <[email protected]>

값 배율·I2C 주소·비차단 단발 측정

SHT3x-DIS는 온도와 상대 습도를, STS3x-DIS는 온도를 측정합니다. 온도는 섭씨, 상대 습도는 백분율로 정의되며 sysfs에서는 모든 값을 1000배로 표시합니다. 따라서 31.5°C는 `31500`입니다.

SHT3x 센서 주소는 배선에 따라 `0x44` 또는 `0x45`이고 STS3x는 `0x4a` 또는 `0x4b`입니다. 장치 생성 방법은 `Documentation/i2c/instantiating-devices.rst`를 참고합니다.

SHT3x는 단발 측정에서 클록 스트레치 기반 차단 모드와 비스트레치 비차단 모드를 모두 지원하지만 이 드라이버는 비차단 모드만 지원합니다.

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

This driver implements support for the Sensirion SHT3x-DIS and STS3x-DIS
series of humidity and temperature sensors. Temperature is measured in degrees
celsius, relative humidity is expressed as a percentage. In the sysfs interface,
all values are scaled by 1000, i.e. the value for 31.5 degrees celsius is 31500.

The device communicates with the I2C protocol. Sensors can have the I2C
addresses 0x44 or 0x45 (0x4a or 0x4b for sts3x), depending on the wiring. See
Documentation/i2c/instantiating-devices.rst for methods to instantiate the
device.

Even if sht3x sensor supports clock-stretch (blocking mode) and non-stretch
(non-blocking mode) in single-shot mode, this driver only supports the latter.

The sht3x sensor supports a single shot mode as well as 5 periodic measure
modes, which can be controlled with the update_interval sysfs interface.

측정 주기와 히스테리시스 경보

센서는 단발 모드와 다섯 가지 주기 측정 모드를 지원하며 `update_interval`로 제어합니다. 허용 값은 0, 2000, 1000, 500, 250, 100 ms이고 각각 단발, 0.5, 1, 2, 4, 10 Hz에 대응합니다.

주기 모드에서는 칩이 설정한 간격마다 측정을 자동으로 시작합니다. 온도나 습도가 설정 한계를 넘으면 해당 alarm 속성이 1이 되고 센서 alert 핀이 high가 됩니다.

온도와 습도가 히스테리시스 값 사이로 돌아오면 alarm 비트는 0이 되고 alert 핀은 low로 내려갑니다.

debugfs에 노출되는 일련번호는 센서를 고유하게 식별합니다. STS32, STS33, SHT33은 제조사가 API를 통해 보정 인증서를 제공합니다.

The allowed update_interval in milliseconds are as follows:

    ===== ======= ====================
       0          single shot mode
    2000   0.5 Hz periodic measurement
    1000   1   Hz periodic measurement
     500   2   Hz periodic measurement
     250   4   Hz periodic measurement
     100  10   Hz periodic measurement
    ===== ======= ====================

In the periodic measure mode, the sensor automatically triggers a measurement
with the configured update interval on the chip. When a temperature or humidity
reading exceeds the configured limits, the alert attribute is set to 1 and
the alert pin on the sensor is set to high.
When the temperature and humidity readings move back between the hysteresis
values, the alert bit is set to 0 and the alert pin on the sensor is set to
low.

The serial number exposed to debugfs allows for unique identification of the
sensors. For sts32, sts33 and sht33, the manufacturer provides calibration
certificates through an API.

한계·경보·히터·반복성 sysfs

`temp1_input`과 `humidity1_input`은 현재 온도와 습도입니다. 최대 한계는 `temp1_max`, `humidity1_max`, 최대 한계의 복귀 히스테리시스는 `temp1_max_hyst`, `humidity1_max_hyst`로 설정합니다.

최소 한계는 `temp1_min`, `humidity1_min`, 최소 한계 히스테리시스는 `temp1_min_hyst`, `humidity1_min_hyst`입니다.

`temp1_alarm`과 `humidity1_alarm`은 측정값이 설정 한계 밖이면 1이 됩니다. 이 경보는 주기 측정 모드에서만 동작합니다.

`heater_enable`은 센서의 과도한 습기를 제거하는 히터를 제어하며 0은 끔, 1은 켬입니다. `update_interval`은 0이면 단발 모드이고 주기 모드에서는 밀리초 간격입니다. 지원하지 않는 값을 쓰면 그보다 빠른 다음 지원 간격을 선택합니다.

`repeatability`는 반복성·측정 시간·잡음·에너지 소비의 절충을 정합니다. 0은 낮은 반복성, 1은 중간, 2는 높은 반복성입니다. 반복성이 높을수록 측정 시간과 에너지 소비가 늘고 잡음은 줄어듭니다.

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

=================== ============================================================
temp1_input:        temperature input
humidity1_input:    humidity input
temp1_max:          temperature max value
temp1_max_hyst:     temperature hysteresis value for max limit
humidity1_max:      humidity max value
humidity1_max_hyst: humidity hysteresis value for max limit
temp1_min:          temperature min value
temp1_min_hyst:     temperature hysteresis value for min limit
humidity1_min:      humidity min value
humidity1_min_hyst: humidity hysteresis value for min limit
temp1_alarm:        alarm flag is set to 1 if the temperature is outside the
                    configured limits. Alarm only works in periodic measure mode
humidity1_alarm:    alarm flag is set to 1 if the humidity is outside the
                    configured limits. Alarm only works in periodic measure mode
heater_enable:      heater enable, heating element removes excess humidity from
                    sensor:

                        - 0: turned off
                        - 1: turned on
update_interval:    update interval, 0 for single shot, interval in msec
                    for periodic measurement. If the interval is not supported
                    by the sensor, the next faster interval is chosen
repeatability:      write or read repeatability, higher repeatability means
                    longer measurement duration, lower noise level and
                    larger energy consumption:

                        - 0: low repeatability
                        - 1: medium repeatability
                        - 2: high repeatability
=================== ============================================================

고유 일련번호 debugfs

debugfs의 `serial_number`는 센서의 고유 일련번호를 십진수로 제공합니다. 이 값으로 동일 모델의 여러 센서를 구분하고 보정 인증서 API의 대상 장치를 식별할 수 있습니다.

debugfs-Interface
-----------------

=================== ============================================================
serial_number:      unique serial number of the sensor in decimal
=================== ============================================================