요약·해설, 영어 원문, 전체 번역을 구분해 실었습니다. API 이름, 코드 심벌, 소스 경로는 원문 표기를 유지합니다.
1. 요약·해설
원문의 핵심 내용을 정리하고 커널 프로그래밍에 필요한 설명을 덧붙였습니다. 아래의 전체 번역과는 별도로 작성한 해설입니다.
2. 영어 원문 전체
번역에 사용한 Linux v6.18.37 원문입니다. 줄 번호는 해당 버전의 소스 파일을 기준으로 합니다.
원문 전체 펼치기
# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
%YAML 1.2
---
$id: http://devicetree.org/schemas/thermal/st,stm32-thermal.yaml#
$schema: http://devicetree.org/meta-schemas/core.yaml#
title: STMicroelectronics STM32 digital thermal sensor (DTS)
maintainers:
- Pascal Paillet <[email protected]>
$ref: thermal-sensor.yaml#
properties:
compatible:
const: st,stm32-thermal
reg:
maxItems: 1
interrupts:
maxItems: 1
clocks:
maxItems: 1
clock-names:
items:
- const: pclk
"#thermal-sensor-cells":
const: 0
required:
- compatible
- reg
- interrupts
- clocks
- clock-names
unevaluatedProperties: false
examples:
- |
#include <dt-bindings/interrupt-controller/arm-gic.h>
#include <dt-bindings/clock/stm32mp1-clks.h>
dts: thermal@50028000 {
compatible = "st,stm32-thermal";
reg = <0x50028000 0x100>;
clocks = <&rcc TMPSENS>;
clock-names = "pclk";
#thermal-sensor-cells = <0>;
interrupts = <GIC_SPI 147 IRQ_TYPE_LEVEL_HIGH>;
};
thermal-zones {
cpu_thermal: cpu-thermal {
polling-delay-passive = <0>;
polling-delay = <0>;
thermal-sensors = <&dts>;
trips {
cpu_alert1: cpu-alert1 {
temperature = <85000>;
hysteresis = <0>;
type = "passive";
};
cpu_crit: cpu-crit {
temperature = <120000>;
hysteresis = <0>;
type = "critical";
};
};
cooling-maps {
};
};
};
...
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미에 맞춰 전체 내용을 번역했습니다. 코드, 함수명, 코드 심벌, URL은 원문 표기를 유지합니다.
STM32 digital thermal sensor
1-13이 GPL-2.0-only 또는 BSD-2-Clause YAML 스키마는 STMicroelectronics STM32 digital thermal sensor(DTS)를 정의합니다. Maintainer는 Pascal Paillet이며 공통 `thermal-sensor.yaml#` 스키마를 사용합니다.
Register, interrupt와 pclk
14-33`compatible`은 `st,stm32-thermal`입니다. `reg`, `interrupts`, `clocks`는 각각 최대 한 항목이고 clock 이름은 `pclk`입니다. `#thermal-sensor-cells = 0`이므로 consumer는 sensor ID를 전달하지 않습니다.
properties:
compatible:
const: st,stm32-thermal
reg:
maxItems: 1
interrupts:
maxItems: 1
clocks:
maxItems: 1
clock-names:
items:
- const: pclk
"#thermal-sensor-cells":
const: 0
필수 속성과 제한
34-42`compatible`, `reg`, `interrupts`, `clocks`, `clock-names`가 모두 필수입니다. `unevaluatedProperties: false`로 추가 속성을 제한합니다.
required:
- compatible
- reg
- interrupts
- clocks
- clock-names
unevaluatedProperties: false
STM32 DTS 노드 예제
43-55예제는 `0x50028000`의 0x100-byte DTS, RCC `TMPSENS` clock, `pclk` 이름, GIC SPI 147 level-high interrupt를 연결하고 0-cell provider로 선언합니다.
- |
#include <dt-bindings/interrupt-controller/arm-gic.h>
#include <dt-bindings/clock/stm32mp1-clks.h>
dts: thermal@50028000 {
compatible = "st,stm32-thermal";
reg = <0x50028000 0x100>;
clocks = <&rcc TMPSENS>;
clock-names = "pclk";
#thermal-sensor-cells = <0>;
interrupts = <GIC_SPI 147 IRQ_TYPE_LEVEL_HIGH>;
};
STM32 thermal zone과 trip
56-80CPU thermal zone은 두 polling delay를 모두 0으로 두고 DTS를 감시합니다. Passive alert trip은 85000 millidegree, critical trip은 120000 millidegree이며 두 trip 모두 hysteresis 0입니다. 빈 `cooling-maps` container도 제시합니다.
thermal-zones {
cpu_thermal: cpu-thermal {
polling-delay-passive = <0>;
polling-delay = <0>;
thermal-sensors = <&dts>;
trips {
cpu_alert1: cpu-alert1 {
temperature = <85000>;
hysteresis = <0>;
type = "passive";
};
cpu_crit: cpu-crit {
temperature = <120000>;
hysteresis = <0>;
type = "critical";
};
};
cooling-maps {
};
};
};
...
요약과 해설
st,stm32-thermal.yaml:1-80STM32 DTS의 pclk·interrupt와 passive·critical trip 예제를 설명합니다. 접을 수 있는 영어 원문 전체는 줄 좌표를 보존하고, 한국어 전문 번역에서는 compatible·property·phandle·register·interrupt·clock·NVMEM·수치·예제 코드를 원형대로 유지합니다.