Airoha EN7581 Thermal Sensor

요약·해설, 영어 원문, 전체 번역을 구분해 실었습니다. API 이름, 코드 심벌, 소스 경로는 원문 표기를 유지합니다.

1. 요약·해설

원문의 핵심 내용을 정리하고 커널 프로그래밍에 필요한 설명을 덧붙였습니다. 아래의 전체 번역과는 별도로 작성한 해설입니다.

요약과 해설

airoha,en7581-thermal.yaml:1-48

EN7581 sensor의 interrupt와 chip SCU 연결을 설명합니다. 접을 수 있는 영어 원문 전체와 줄 좌표를 보존하고, 한국어 전문 번역에서는 compatible·property·phandle·clock·interrupt·수치·예제 코드를 원형대로 유지합니다.

2. 영어 원문 전체

번역에 사용한 Linux v6.18.37 원문입니다. 줄 번호는 해당 버전의 소스 파일을 기준으로 합니다.

원문 전체 펼치기

1 # SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)

2 %YAML 1.2

3 ---

4 $id: http://devicetree.org/schemas/thermal/airoha,en7581-thermal.yaml#

5 $schema: http://devicetree.org/meta-schemas/core.yaml#

7 title: Airoha EN7581 Thermal Sensor and Monitor

9 maintainers:

10 - Christian Marangi <[email protected]>

12 properties:

13 compatible:

14 const: airoha,en7581-thermal

16 reg:

17 maxItems: 1

19 interrupts:

20 maxItems: 1

22 airoha,chip-scu:

23 description: phandle to the chip SCU syscon

24 $ref: /schemas/types.yaml#/definitions/phandle

26 '#thermal-sensor-cells':

27 const: 0

29 required:

30 - compatible

31 - reg

32 - interrupts

33 - airoha,chip-scu

35 additionalProperties: false

37 examples:

38 - |

39 #include <dt-bindings/interrupt-controller/arm-gic.h>

41 thermal-sensor@1efbd800 {

42 compatible = "airoha,en7581-thermal";

43 reg = <0x1efbd000 0xd5c>;

44 interrupts = <GIC_SPI 23 IRQ_TYPE_LEVEL_HIGH>;

45 airoha,chip-scu = <&chip_scu>;

47 #thermal-sensor-cells = <0>;

48 };

3. 한국어 전문 번역

영어 원문의 문단 순서와 의미에 맞춰 전체 내용을 번역했습니다. 코드, 함수명, 코드 심벌, URL은 원문 표기를 유지합니다.

1-11

이 GPL-2.0 또는 BSD-2-Clause YAML schema는 Airoha EN7581 Thermal Sensor and Monitor를 정의합니다. Maintainer는 Christian Marangi입니다.

Register·interrupt와 SCU phandle

12-28

`compatible`은 `airoha,en7581-thermal`입니다. `reg`와 `interrupts`는 각각 최대 한 항목입니다. `airoha,chip-scu`는 chip SCU syscon을 가리키는 `phandle`입니다. `#thermal-sensor-cells`는 0입니다.

필수 속성과 추가 속성 제한

29-36

필수 속성은 `compatible`, `reg`, `interrupts`, `airoha,chip-scu`입니다. `additionalProperties: false`로 정의하지 않은 추가 속성을 금지합니다.

EN7581 sensor 예제

37-48

예제는 0x1efbd000부터 0xd5c 크기의 register 영역, GIC SPI 23 level-high interrupt, `chip_scu` phandle과 0-cell thermal sensor를 구성합니다.

#include <dt-bindings/interrupt-controller/arm-gic.h>

thermal-sensor@1efbd800 {
    compatible = "airoha,en7581-thermal";
    reg = <0x1efbd000 0xd5c>;
    interrupts = <GIC_SPI 23 IRQ_TYPE_LEVEL_HIGH>;
    airoha,chip-scu = <&chip_scu>;

    #thermal-sensor-cells = <0>;
};