Amazon Annapurna Labs Thermal Sensor

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

1. 요약·해설

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

요약과 해설

amazon,al-thermal.txt:1-33

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

2. 영어 원문 전체

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

원문 전체 펼치기

1 Amazon's Annapurna Labs Thermal Sensor

3 Simple thermal device that allows temperature reading by a single MMIO

4 transaction.

6 Required properties:

7 - compatible: "amazon,al-thermal".

8 - reg: The physical base address and length of the sensor's registers.

9 - #thermal-sensor-cells: Must be 1. See Documentation/devicetree/bindings/thermal/thermal-sensor.yaml for a description.

11 Example:

12 thermal: thermal {

13 compatible = "amazon,al-thermal";

14 reg = <0x0 0x05002860 0x0 0x1>;

15 #thermal-sensor-cells = <0x1>;

16 };

18 thermal-zones {

19 thermal-z0 {

20 polling-delay-passive = <250>;

21 polling-delay = <1000>;

22 thermal-sensors = <&thermal 0>;

23 trips {

24 critical {

25 temperature = <105000>;

26 hysteresis = <2000>;

27 type = "critical";

28 };

29 };

31 };

32 };

3. 한국어 전문 번역

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

1-5

Amazon Annapurna Labs thermal sensor는 단일 MMIO transaction으로 온도를 읽을 수 있는 simple thermal device입니다.

필수 속성

6-10

필수 속성은 `amazon,al-thermal` compatible, sensor register의 physical base address와 length를 담는 `reg`, 값이 반드시 1인 `#thermal-sensor-cells`입니다. Cell 설명은 `Documentation/devicetree/bindings/thermal/thermal-sensor.yaml`을 참고합니다.

Sensor와 critical trip 예제

11-33

예제는 0x05002860의 1-byte sensor를 thermal zone 0에 연결합니다. Passive polling delay는 250 ms, 일반 polling delay는 1000 ms이며 critical trip은 105000 millidegree, hysteresis 2000으로 설정합니다.

thermal: thermal {
        compatible = "amazon,al-thermal";
        reg = <0x0 0x05002860 0x0 0x1>;
        #thermal-sensor-cells = <0x1>;
};

thermal-zones {
        thermal-z0 {
                polling-delay-passive = <250>;
                polling-delay = <1000>;
                thermal-sensors = <&thermal 0>;
                trips {
                        critical {
                                temperature = <105000>;
                                hysteresis = <2000>;
                                type = "critical";
                        };
                };

        };
};