← Documents Documentation/devicetree/bindings/thermal/imx8mm-thermal.yaml GitHub 원문 ↗

Linux 6.18.37 · Devicetree Bindings / Thermal

NXP i.MX8M Mini Thermal

i.MX8M TMU version별 sensor 수와 calibration 속성을 설명합니다.

Source pathDocumentation/devicetree/bindings/thermal/imx8mm-thermal.yaml
Source versionLinux v6.18.37
TranslationDUJINLABS 전문 번역 + 해설

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

1. 요약·해설

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

요약과 해설

imx8mm-thermal.yaml:1-72

i.MX8M TMU version별 sensor 수와 calibration 속성을 설명합니다. 접을 수 있는 영어 원문 전체는 줄 좌표를 보존하고, 한국어 전문 번역에서는 compatible·property·phandle·register·interrupt·수치·예제 코드를 원형대로 유지합니다.

2. 영어 원문 전체

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

원문 전체 펼치기
1 # SPDX-License-Identifier: GPL-2.0
2 %YAML 1.2
3 ---
4 $id: http://devicetree.org/schemas/thermal/imx8mm-thermal.yaml#
5 $schema: http://devicetree.org/meta-schemas/core.yaml#
6
7 title: NXP i.MX8M Mini Thermal
8
9 maintainers:
10 - Shawn Guo <[email protected]>
11 - Sascha Hauer <[email protected]>
12 - Fabio Estevam <[email protected]>
13
14 description: |
15 i.MX8MM has TMU IP to allow temperature measurement, there are
16 currently two distinct major versions of the IP that is supported
17 by a single driver. The IP versions are named v1 and v2, v1 is
18 for i.MX8MM which has ONLY 1 sensor, v2 is for i.MX8MP which has
19 2 sensors.
20
21 $ref: thermal-sensor.yaml#
22
23 properties:
24 compatible:
25 oneOf:
26 - enum:
27 - fsl,imx8mm-tmu
28 - fsl,imx8mp-tmu
29 - items:
30 - const: fsl,imx8mn-tmu
31 - const: fsl,imx8mm-tmu
32
33 reg:
34 maxItems: 1
35
36 clocks:
37 maxItems: 1
38
39 nvmem-cells:
40 maxItems: 1
41 description: Phandle to the calibration data provided by ocotp
42
43 nvmem-cell-names:
44 const: calib
45
46 "#thermal-sensor-cells":
47 description: |
48 Number of cells required to uniquely identify the thermal
49 sensors, 0 for ONLY one sensor and 1 for multiple sensors.
50 enum:
51 - 0
52 - 1
53
54 required:
55 - compatible
56 - reg
57 - clocks
58
59 unevaluatedProperties: false
60
61 examples:
62 - |
63 #include <dt-bindings/clock/imx8mm-clock.h>
64
65 thermal-sensor@30260000 {
66 compatible = "fsl,imx8mm-tmu";
67 reg = <0x30260000 0x10000>;
68 clocks = <&clk IMX8MM_CLK_TMU_ROOT>;
69 #thermal-sensor-cells = <0>;
70 };
71
72 ...
73

3. 한국어 전문 번역

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

NXP i.MX8M Mini Thermal

1-22

이 GPL-2.0 YAML 스키마는 i.MX8M Mini의 TMU IP를 정의하고 공통 `thermal-sensor.yaml#` 스키마를 참조합니다. 단일 driver가 서로 다른 두 major version을 지원합니다. v1인 i.MX8MM에는 sensor가 하나만 있고, v2인 i.MX8MP에는 sensor가 두 개 있습니다. Maintainer는 Shawn Guo, Sascha Hauer, Fabio Estevam입니다.

i.MX8MM·i.MX8MP·i.MX8MN

23-32

`compatible`은 `fsl,imx8mm-tmu` 또는 `fsl,imx8mp-tmu`를 단독으로 사용합니다. i.MX8MN은 `fsl,imx8mn-tmu` 뒤에 `fsl,imx8mm-tmu` fallback을 둡니다.

Register, clock, calibration, sensor cells

33-53

`reg`와 `clocks`는 각각 최대 한 항목입니다. 선택적 `nvmem-cells`는 OCOTP calibration data phandle 하나를 받고 `nvmem-cell-names`는 `calib`입니다. `#thermal-sensor-cells`는 sensor가 하나뿐이면 0, 여러 sensor를 구분해야 하면 1이며 두 값만 허용됩니다.

필수 속성과 추가 속성 제한

54-60

필수 속성은 `compatible`, `reg`, `clocks`입니다. `unevaluatedProperties: false`로 공통 thermal sensor 스키마에서 평가되지 않은 추가 속성을 금지합니다.

i.MX8MM TMU 예제

61-72

예제는 0x30260000의 0x10000-byte TMU register, `IMX8MM_CLK_TMU_ROOT` clock을 사용하고 sensor가 하나뿐이므로 `#thermal-sensor-cells = <0>`을 지정합니다.

    #include <dt-bindings/clock/imx8mm-clock.h>

    thermal-sensor@30260000 {
        compatible = "fsl,imx8mm-tmu";
        reg = <0x30260000 0x10000>;
        clocks = <&clk IMX8MM_CLK_TMU_ROOT>;
        #thermal-sensor-cells = <0>;
    };

...