← Documents Documentation/devicetree/bindings/thermal/renesas,r9a09g047-tsu.yaml GitHub 원문 ↗

Linux 6.18.37 · Devicetree Bindings / Thermal

Renesas RZ/G3E Temperature Sensor Unit

RZ/G3E TSU의 변환·비교 인터럽트와 OTP trim 참조를 설명합니다.

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

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

1. 요약·해설

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

요약과 해설

renesas,r9a09g047-tsu.yaml:1-87

RZ/G3E TSU의 변환·비교 인터럽트와 OTP trim 참조를 설명합니다. 접을 수 있는 영어 원문 전체는 줄 좌표를 보존하고, 한국어 전문 번역에서는 compatible·property·phandle·register·interrupt·clock·reset·수치·예제 코드를 원형대로 유지합니다.

2. 영어 원문 전체

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

원문 전체 펼치기
1 # SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2 %YAML 1.2
3 ---
4 $id: http://devicetree.org/schemas/thermal/renesas,r9a09g047-tsu.yaml#
5 $schema: http://devicetree.org/meta-schemas/core.yaml#
6
7 title: Renesas RZ/G3E Temperature Sensor Unit (TSU)
8
9 maintainers:
10 - John Madieu <john.madieu.xa@bp.renesas.com>
11
12 description:
13 The Temperature Sensor Unit (TSU) is an integrated thermal sensor that
14 monitors the chip temperature on the Renesas RZ/G3E SoC. The TSU provides
15 real-time temperature measurements for thermal management.
16
17 properties:
18 compatible:
19 const: renesas,r9a09g047-tsu
20
21 reg:
22 maxItems: 1
23
24 clocks:
25 maxItems: 1
26
27 resets:
28 maxItems: 1
29
30 power-domains:
31 maxItems: 1
32
33 interrupts:
34 items:
35 - description: Conversion complete interrupt signal (pulse)
36 - description: Comparison result interrupt signal (level)
37
38 interrupt-names:
39 items:
40 - const: adi
41 - const: adcmpi
42
43 "#thermal-sensor-cells":
44 const: 0
45
46 renesas,tsu-trim:
47 $ref: /schemas/types.yaml#/definitions/phandle-array
48 items:
49 - items:
50 - description: phandle to system controller
51 - description: offset of trim registers
52 description:
53 Phandle and offset to the system controller containing the TSU
54 calibration trim values. The offset points to the first trim register
55 (OTPTSU1TRMVAL0), with the second trim register (OTPTSU1TRMVAL1) located
56 at offset + 4.
57
58 required:
59 - compatible
60 - reg
61 - clocks
62 - resets
63 - power-domains
64 - interrupts
65 - interrupt-names
66 - "#thermal-sensor-cells"
67 - renesas,tsu-trim
68
69 additionalProperties: false
70
71 examples:
72 - |
73 #include <dt-bindings/clock/renesas,r9a09g047-cpg.h>
74 #include <dt-bindings/interrupt-controller/arm-gic.h>
75
76 thermal-sensor@14002000 {
77 compatible = "renesas,r9a09g047-tsu";
78 reg = <0x14002000 0x1000>;
79 clocks = <&cpg CPG_MOD 0x10a>;
80 resets = <&cpg 0xf8>;
81 power-domains = <&cpg>;
82 interrupts = <GIC_SPI 250 IRQ_TYPE_EDGE_RISING>,
83 <GIC_SPI 251 IRQ_TYPE_LEVEL_HIGH>;
84 interrupt-names = "adi", "adcmpi";
85 #thermal-sensor-cells = <0>;
86 renesas,tsu-trim = <&sys 0x330>;
87 };
88

3. 한국어 전문 번역

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

Renesas RZ/G3E Temperature Sensor Unit

1-16

이 GPL-2.0-only 또는 BSD-2-Clause YAML 스키마는 Renesas RZ/G3E Temperature Sensor Unit(TSU)을 정의합니다. TSU는 칩 온도를 감시하는 내장 thermal sensor이며 thermal management에 실시간 온도 측정값을 제공합니다. Maintainer는 John Madieu입니다.

두 인터럽트와 0-cell provider

17-45

`compatible`은 `renesas,r9a09g047-tsu`입니다. `reg`, `clocks`, `resets`, `power-domains`는 각각 최대 한 항목입니다. 첫 인터럽트는 conversion complete pulse이고 이름은 `adi`, 둘째는 comparison result level 신호이고 이름은 `adcmpi`입니다. `#thermal-sensor-cells = 0`입니다.

properties:
  compatible:
    const: renesas,r9a09g047-tsu

  reg:
    maxItems: 1

  clocks:
    maxItems: 1

  resets:
    maxItems: 1

  power-domains:
    maxItems: 1

  interrupts:
    items:
      - description: Conversion complete interrupt signal (pulse)
      - description: Comparison result interrupt signal (level)

  interrupt-names:
    items:
      - const: adi
      - const: adcmpi

  "#thermal-sensor-cells":
    const: 0

System controller의 TSU trim 값

46-57

`renesas,tsu-trim`은 system controller phandle과 trim register offset으로 이루어진 `phandle-array`입니다. Offset은 첫 trim register `OTPTSU1TRMVAL0`을 가리키며 둘째 register `OTPTSU1TRMVAL1`은 그 위치에서 `+ 4`에 있습니다.

renesas,tsu-trim:
  $ref: /schemas/types.yaml#/definitions/phandle-array
  items:
    - items:
        - description: phandle to system controller
        - description: offset of trim registers
  description:
    Phandle and offset to the system controller containing the TSU
    calibration trim values. The offset points to the first trim register
    (OTPTSU1TRMVAL0), with the second trim register (OTPTSU1TRMVAL1) located
    at offset + 4.

필수 속성과 제한

58-70

`compatible`, `reg`, `clocks`, `resets`, `power-domains`, `interrupts`, `interrupt-names`, `#thermal-sensor-cells`, `renesas,tsu-trim`이 모두 필수입니다. `additionalProperties: false`로 추가 속성을 금지합니다.

required:
  - compatible
  - reg
  - clocks
  - resets
  - power-domains
  - interrupts
  - interrupt-names
  - "#thermal-sensor-cells"
  - renesas,tsu-trim

additionalProperties: false

RZ/G3E TSU 예제

71-87

예제는 `0x14002000`의 0x1000-byte TSU, CPG module clock `0x10a`, reset `0xf8`, CPG power domain을 선언합니다. GIC SPI 250 edge-rising은 `adi`, GIC SPI 251 level-high는 `adcmpi`이며 trim 값은 system controller offset `0x330`에서 읽습니다.

- |
  #include <dt-bindings/clock/renesas,r9a09g047-cpg.h>
  #include <dt-bindings/interrupt-controller/arm-gic.h>

  thermal-sensor@14002000 {
      compatible = "renesas,r9a09g047-tsu";
      reg = <0x14002000 0x1000>;
      clocks = <&cpg CPG_MOD 0x10a>;
      resets = <&cpg 0xf8>;
      power-domains = <&cpg>;
      interrupts = <GIC_SPI 250 IRQ_TYPE_EDGE_RISING>,
                   <GIC_SPI 251 IRQ_TYPE_LEVEL_HIGH>;
      interrupt-names = "adi", "adcmpi";
      #thermal-sensor-cells = <0>;
      renesas,tsu-trim = <&sys 0x330>;
  };