Samsung Exynos Thermal Management Unit

Samsung Exynos Thermal Management Unit

이 GPL-2.0-only 또는 BSD-2-Clause YAML 스키마는 Samsung Exynos SoC Thermal Management Unit(TMU)을 정의합니다. TMU instance가 여러 개이면 각 instance에 `aliases` node에서 올바르게 번호를 매긴 alias가 있어야 합니다. Maintainer는 Krzysztof Kozlowski입니다.

지원 Exynos TMU compatible

Exynos3250, 4412, 4210, 5250, 5260, 5420, 5433, Exynos7 TMU를 지원합니다. Exynos5420의 channel 0·1은 `samsung,exynos5420-tmu`, channel 2·3·4처럼 TRIMINFO 위치가 다른 경우는 `samsung,exynos5420-tmu-ext-triminfo`를 사용합니다.

properties:
  compatible:
    enum:
      - samsung,exynos3250-tmu
      - samsung,exynos4412-tmu
      - samsung,exynos4210-tmu
      - samsung,exynos5250-tmu
      - samsung,exynos5260-tmu
        # For TMU channel 0, 1 on Exynos5420:
      - samsung,exynos5420-tmu
        # For TMU channels 2, 3 and 4 of Exynos5420:
      - samsung,exynos5420-tmu-ext-triminfo
      - samsung,exynos5433-tmu
      - samsung,exynos7-tmu

Clock 수와 thermal trip interrupt

`clocks`와 `clock-names`는 각각 1~3개를 허용합니다. TMU는 지정된 온도 임계값에 도달하면 interrupt를 생성합니다. Devicetree에 정의된 첫 trip부터 구성하며 대부분 SoC는 4개, Exynos5433과 Exynos7은 8개 thermal trip point를 지원합니다. `interrupts` 자체는 최대 한 항목입니다.

clocks:
  minItems: 1
  maxItems: 3

clock-names:
  minItems: 1
  maxItems: 3

interrupts:
  description: |
    The Exynos TMU supports generating interrupts when reaching given
    temperature thresholds. Number of supported thermal trip points depends
    on the SoC (only first trip points defined in DT will be configured)::
     - most of SoC: 4
     - samsung,exynos5433-tmu: 8
     - samsung,exynos7-tmu: 8
  maxItems: 1

Instance register와 shared TRIMINFO

`reg`의 첫 항목은 TMU instance register이고 둘째 선택 항목은 shared TMU register입니다. Exynos5420 channel 2·3·4의 TRIMINFO는 잘못 배치되어 있으므로 ext-triminfo compatible과 shared base 접근 clock을 함께 제공해야 합니다. TRIMINFO 주소는 channel 3이 `0x1006c000`, channel 4가 `0x100a0000`, channel 2가 `0x10068000`입니다. `#thermal-sensor-cells = 0`이고 `vtmu-supply`는 TMU 전압 regulator입니다.

reg:
  items:
    - description: TMU instance registers.
    - description: |
        Shared TMU registers.

        Note:: On Exynos5420, the TRIMINFO register is misplaced for TMU
        channels 2, 3 and 4 Use "samsung,exynos5420-tmu-ext-triminfo" in
        cases, there is a misplaced register, also provide clock to access
        that base.
        TRIMINFO at 0x1006c000 contains data for TMU channel 3
        TRIMINFO at 0x100a0000 contains data for TMU channel 4
        TRIMINFO at 0x10068000 contains data for TMU channel 2
  minItems: 1

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

vtmu-supply:
  description: The regulator node supplying voltage to TMU.

필수 속성과 공통 스키마

`compatible`, `clocks`, `clock-names`, `interrupts`, `reg`가 필수입니다. 공통 `/schemas/thermal/thermal-sensor.yaml`도 함께 적용합니다.

required:
  - compatible
  - clocks
  - clock-names
  - interrupts
  - reg

allOf:
  - $ref: /schemas/thermal/thermal-sensor.yaml

Exynos5420 external TRIMINFO 조건

`samsung,exynos5420-tmu-ext-triminfo`는 TMU channel operational clock과 shared TRIMINFO register 접근 clock 두 개를 사용합니다. 이름은 각각 `tmu_apbif`, `tmu_triminfo_apbif`이며 `reg`도 instance와 shared 범위를 합쳐 정확히 두 항목이어야 합니다.

- if:
    properties:
      compatible:
        contains:
          const: samsung,exynos5420-tmu-ext-triminfo
  then:
    properties:
      clocks:
        items:
          - description:
              Operational clock for TMU channel.
          - description:
              Optional clock to access the shared registers (e.g. TRIMINFO) of TMU
              channel.
      clock-names:
        items:
          - const: tmu_apbif
          - const: tmu_triminfo_apbif
      reg:
        minItems: 2
        maxItems: 2

Exynos5433·Exynos7 clock 조건

Exynos5433과 Exynos7은 TMU channel operational clock과 functional operation용 special clock 두 개를 사용합니다. 이름은 `tmu_apbif`, `tmu_sclk`이며 `reg`는 정확히 한 항목입니다.

- if:
    properties:
      compatible:
        contains:
          enum:
            - samsung,exynos5433-tmu
            - samsung,exynos7-tmu
  then:
    properties:
      clocks:
        items:
          - description:
              Operational clock for TMU channel.
          - description:
              Optional special clock for functional operation of TMU channel.
      clock-names:
        items:
          - const: tmu_apbif
          - const: tmu_sclk
      reg:
        minItems: 1
        maxItems: 1

기존 Exynos 단일 clock 조건

Exynos3250, 4412, 4210, 5250, 5260과 일반 Exynos5420 compatible은 clock 1개와 register 범위 1개만 사용합니다. `additionalProperties: false`로 정의되지 않은 속성을 금지합니다.

  - if:
      properties:
        compatible:
          contains:
            enum:
              - samsung,exynos3250-tmu
              - samsung,exynos4412-tmu
              - samsung,exynos4210-tmu
              - samsung,exynos5250-tmu
              - samsung,exynos5260-tmu
              - samsung,exynos5420-tmu
    then:
      properties:
        clocks:
          minItems: 1
          maxItems: 1
        reg:
          minItems: 1
          maxItems: 1

additionalProperties: false

Exynos4412 TMU 예제

첫 예제는 `0x100c0000`의 Exynos4412 TMU, combiner interrupt `<2 4>`, `CLK_TMU_APBIF`, `tmu_apbif` clock name과 `ldo10_reg` 공급 regulator를 사용합니다.

- |
  #include <dt-bindings/clock/exynos4.h>

  tmu@100c0000 {
      compatible = "samsung,exynos4412-tmu";
      reg = <0x100C0000 0x100>;
      interrupt-parent = <&combiner>;
      interrupts = <2 4>;
      #thermal-sensor-cells = <0>;
      clocks = <&clock CLK_TMU_APBIF>;
      clock-names = "tmu_apbif";
      vtmu-supply = <&ldo10_reg>;
  };

Exynos5420 external TRIMINFO 예제

둘째 예제는 channel 2의 instance base `0x10068000`과 channel 3 TRIMINFO shared base `0x1006c000`을 함께 지정합니다. GIC SPI 184, 두 개의 CLK_TMU handle, `tmu_apbif`·`tmu_triminfo_apbif` 이름과 `ldo7_reg`를 사용합니다.

- |
  #include <dt-bindings/interrupt-controller/arm-gic.h>

  tmu@10068000 {
      compatible = "samsung,exynos5420-tmu-ext-triminfo";
      reg = <0x10068000 0x100>, <0x1006c000 0x4>;
      interrupts = <GIC_SPI 184 IRQ_TYPE_LEVEL_HIGH>;
      #thermal-sensor-cells = <0>;
      clocks = <&clock 318>, <&clock 318>; /* CLK_TMU */
      clock-names = "tmu_apbif", "tmu_triminfo_apbif";
      vtmu-supply = <&ldo7_reg>;
  };

Exynos5433 TMU 예제

셋째 예제는 `0x10060000`의 0x200-byte Exynos5433 TMU, GIC SPI 95, APB interface clock과 special functional clock을 사용합니다. Clock 이름은 `tmu_apbif`, `tmu_sclk`이며 공급 regulator는 `ldo3_reg`입니다.

- |
  #include <dt-bindings/interrupt-controller/arm-gic.h>

  tmu@10060000 {
      compatible = "samsung,exynos5433-tmu";
      reg = <0x10060000 0x200>;
      interrupts = <GIC_SPI 95 IRQ_TYPE_LEVEL_HIGH>;
      #thermal-sensor-cells = <0>;
      clocks = <&cmu_peris 3>, /* CLK_PCLK_TMU0_APBIF */
               <&cmu_peris 35>; /* CLK_SCLK_TMU0 */
      clock-names = "tmu_apbif", "tmu_sclk";
      vtmu-supply = <&ldo3_reg>;
  };