Documentation/devicetree/bindings/thermal/amazon,al-thermal.txt GitHub 원문 ↗

Linux 6.18.37 · Devicetree Bindings / Thermal

Amazon Annapurna Labs Thermal Sensor

Amazon Alpine MMIO sensor와 critical thermal trip 예제를 설명합니다.

Source pathDocumentation/devicetree/bindings/thermal/amazon,al-thermal.txt
Source versionLinux v6.18.37
TranslationDUJINLABS 전문 번역 + 해설

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

1. 요약·해설

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

요약과 해설

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
2
3 Simple thermal device that allows temperature reading by a single MMIO
4 transaction.
5
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.
10
11 Example:
12 thermal: thermal {
13 compatible = "amazon,al-thermal";
14 reg = <0x0 0x05002860 0x0 0x1>;
15 #thermal-sensor-cells = <0x1>;
16 };
17
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 };
30
31 };
32 };
33
34

3. 한국어 전문 번역

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

Amazon Annapurna Labs thermal sensor

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";
                        };
                };

        };
};