Kernel driver aht10 | Linux 6.18.37

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

1. 요약·해설

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

요약·해설

aht10.rst:1-64

고정 주소 0x38의 온습도 센서를 명시적으로 등록하고, AHT20/DHT20의 CRC8과 최소 polling interval을 적용합니다.

문서 개요

항목값

SourceDocumentation/hwmon/aht10.rst

분량64 source lines

주소I2C 0x38

최소 interval2000ms

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

핵심 흐름

장치를 주소 0x38로 선언온도·습도 측정필요하면 CRC8 검증Sysfs 값 갱신

장치를 구성하고 측정·제어하는 기본 순서입니다.

2. 영어 원문 전체

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

원문 전체 펼치기

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

3 Kernel driver aht10

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

6 Supported chips:

8 * Aosong AHT10/AHT20

10 Prefix: 'aht10'

12 Addresses scanned: None

14 Datasheet(AHT10):

16 Chinese: http://www.aosong.com/userfiles/files/media/AHT10%E4%BA%A7%E5%93%81%E6%89%8B%E5%86%8C%20A3%2020201210.pdf

17 English: https://server4.eca.ir/eshop/AHT10/Aosong_AHT10_en_draft_0c.pdf

19 Datasheet(AHT20):

21 English: http://www.aosong.com/userfiles/files/media/Data%20Sheet%20AHT20.pdf

23 * Aosong DHT20

25 Prefix: 'dht20'

27 Addresses scanned: None

29 Datasheet: https://www.digikey.co.nz/en/htmldatasheets/production/9184855/0/0/1/101020932

31 Author: Johannes Cornelis Draaijer <jcdra1@gmail.com>

34 Description

35 -----------

37 The AHT10/AHT20 is a Temperature and Humidity sensor

39 The address of this i2c device may only be 0x38

41 Special Features

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

44 AHT20, DHT20 has additional CRC8 support which is sent as the last byte of the sensor

45 values.

47 Usage Notes

48 -----------

50 This driver does not probe for AHT10/ATH20 devices, as there is no reliable

51 way to determine if an i2c chip is or isn't an AHT10/AHT20. The device has

52 to be instantiated explicitly with the address 0x38. See

53 Documentation/i2c/instantiating-devices.rst for details.

55 Sysfs entries

56 -------------

58 =============== ============================================

59 temp1_input Measured temperature in millidegrees Celsius

60 humidity1_input Measured humidity in %H

61 update_interval The minimum interval for polling the sensor,

62 in milliseconds. Writable. Must be at

63 least 2000.

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

3. 한국어 전문 번역

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

AHT10, AHT20, DHT20 지원

1-33

이 GPL-2.0 문서의 driver는 Aosong `AHT10`과 `AHT20`을 prefix `aht10`으로 지원합니다. 주소는 검색하지 않으며 문서에는 AHT10의 중국어·영어 데이터시트와 AHT20의 영어 데이터시트 URL이 제공됩니다.

Aosong `DHT20`은 prefix `dht20`으로 지원합니다. 이 모델도 주소를 검색하지 않으며 DigiKey에 게시된 데이터시트 URL이 제공됩니다. 저자는 Johannes Cornelis Draaijer입니다.

AHT 계열 지원

모델Prefix주소 검색데이터시트

AHT10aht10없음중국어·영어

AHT20aht10없음영어

DHT20dht20없음영어

모델, prefix, 주소 검색 정책을 정리합니다.

장치 선언 준비

Sensor 모델 확인AHT10/AHT20 또는 DHT20 prefix 선택고정 주소 0x38 확인I2C 장치를 명시적으로 선언

자동 검색 대신 확실한 board 정보를 사용합니다.

.. SPDX-License-Identifier: GPL-2.0

Kernel driver aht10
=====================

Supported chips:

  * Aosong AHT10/AHT20

    Prefix: 'aht10'

    Addresses scanned: None

    Datasheet(AHT10):

      Chinese: http://www.aosong.com/userfiles/files/media/AHT10%E4%BA%A7%E5%93%81%E6%89%8B%E5%86%8C%20A3%2020201210.pdf
      English: https://server4.eca.ir/eshop/AHT10/Aosong_AHT10_en_draft_0c.pdf

    Datasheet(AHT20):

      English: http://www.aosong.com/userfiles/files/media/Data%20Sheet%20AHT20.pdf

  * Aosong DHT20

    Prefix: 'dht20'

    Addresses scanned: None

    Datasheet: https://www.digikey.co.nz/en/htmldatasheets/production/9184855/0/0/1/101020932

Author: Johannes Cornelis Draaijer <jcdra1@gmail.com>

온습도 측정과 명시적 등록

34-53

AHT10/AHT20은 temperature and humidity sensor입니다. 이 I2C 장치가 사용할 수 있는 주소는 `0x38`뿐입니다.

AHT20과 DHT20은 sensor value의 마지막 byte로 전송되는 추가 `CRC8` 검증을 지원합니다.

어떤 I2C chip이 AHT10/AHT20인지 신뢰성 있게 판별할 방법이 없으므로 driver는 AHT10/AHT20 장치를 probe하지 않습니다. 장치는 주소 `0x38`로 명시적으로 instantiate해야 합니다. 자세한 방법은 `Documentation/i2c/instantiating-devices.rst`를 참고합니다. 원문 50행의 `ATH20` 표기는 AHT20을 가리킵니다.

AHT 계열 통신 특성

항목AHT10AHT20DHT20

I2C 주소0x380x380x38

자동 probe안 함안 함안 함

CRC8없음마지막 byte마지막 byte

공통 주소와 모델별 무결성 검사를 보여 줍니다.

측정값 수신

주소 0x38의 장치에 측정 요청Temperature와 humidity sensor value 수신AHT20/DHT20이면 마지막 byte 분리CRC8 검증유효한 값을 sysfs에 갱신

AHT20과 DHT20은 마지막 byte로 CRC8을 검증합니다.

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

The AHT10/AHT20 is a Temperature and Humidity sensor

The address of this i2c device may only be 0x38

Special Features
----------------

AHT20, DHT20 has additional CRC8 support which is sent as the last byte of the sensor
values.

Usage Notes
-----------

This driver does not probe for AHT10/ATH20 devices, as there is no reliable
way to determine if an i2c chip is or isn't an AHT10/AHT20. The device has
to be instantiated explicitly with the address 0x38. See
Documentation/i2c/instantiating-devices.rst for details.

AHT10 sysfs 항목

54-64

`temp1_input`은 측정 temperature를 millidegrees Celsius 단위로 제공합니다. `humidity1_input`은 측정 humidity를 `%H` 단위로 제공합니다.

`update_interval`은 sensor를 polling하는 minimum interval을 millisecond 단위로 나타냅니다. 이 attribute는 writable이며 최소 `2000`이어야 합니다.

AHT10 sysfs

Attribute의미단위/제약

temp1_input측정 temperaturemillidegrees Celsius

humidity1_input측정 humidity%H

update_interval최소 polling intervalms, writable, 2000 이상

측정값 단위와 polling 제약입니다.

Polling interval 적용

update_interval 요청값 받기2000ms 이상인지 확인유효하면 polling timer 갱신온도와 습도 측정Sysfs input attribute 갱신

너무 잦은 센서 접근을 막도록 최소값을 검증합니다.


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

=============== ============================================
temp1_input     Measured temperature in millidegrees Celsius
humidity1_input Measured humidity in %H
update_interval The minimum interval for polling the sensor,
                in milliseconds. Writable. Must be at
                least 2000.
=============== ============================================