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

Linux 6.18.37 · Devicetree Bindings / Thermal

Qualcomm Limits Management Hardware

Qualcomm LMh thermal FSM의 arm·low·high threshold와 interrupt controller를 설명합니다.

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

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

1. 요약·해설

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

요약과 해설

qcom-lmh.yaml:1-88

Qualcomm LMh thermal FSM의 arm·low·high threshold와 interrupt controller를 설명합니다. 접을 수 있는 영어 원문 전체는 줄 좌표를 보존하고, 한국어 전문 번역에서는 compatible·property·phandle·register·interrupt·수치·예제 코드를 원형대로 유지합니다.

2. 영어 원문 전체

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

원문 전체 펼치기
1 # SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2 # Copyright 2021 Linaro Ltd.
3 %YAML 1.2
4 ---
5 $id: http://devicetree.org/schemas/thermal/qcom-lmh.yaml#
6 $schema: http://devicetree.org/meta-schemas/core.yaml#
7
8 title: Qualcomm Limits Management Hardware(LMh)
9
10 maintainers:
11 - Thara Gopinath <[email protected]>
12
13 description:
14 Limits Management Hardware(LMh) is a hardware infrastructure on some
15 Qualcomm SoCs that can enforce temperature and current limits as
16 programmed by software for certain IPs like CPU.
17
18 properties:
19 compatible:
20 oneOf:
21 - enum:
22 - qcom,sc8180x-lmh
23 - qcom,sdm845-lmh
24 - qcom,sm8150-lmh
25 - items:
26 - const: qcom,qcm2290-lmh
27 - const: qcom,sm8150-lmh
28
29 reg:
30 items:
31 - description: core registers
32
33 interrupts:
34 maxItems: 1
35
36 '#interrupt-cells':
37 const: 1
38
39 interrupt-controller: true
40
41 cpus:
42 description:
43 phandle of the first cpu in the LMh cluster
44 maxItems: 1
45
46 qcom,lmh-temp-arm-millicelsius:
47 description:
48 An integer expressing temperature threshold at which the LMh thermal
49 FSM is engaged.
50
51 qcom,lmh-temp-low-millicelsius:
52 description:
53 An integer expressing temperature threshold at which the state machine
54 will attempt to remove frequency throttling.
55
56 qcom,lmh-temp-high-millicelsius:
57 description:
58 An integer expressing temperature threshold at which the state machine
59 will attempt to throttle the frequency.
60
61 required:
62 - compatible
63 - reg
64 - interrupts
65 - '#interrupt-cells'
66 - interrupt-controller
67 - cpus
68 - qcom,lmh-temp-arm-millicelsius
69 - qcom,lmh-temp-low-millicelsius
70 - qcom,lmh-temp-high-millicelsius
71
72 additionalProperties: false
73
74 examples:
75 - |
76 #include <dt-bindings/interrupt-controller/arm-gic.h>
77
78 lmh@17d70800 {
79 compatible = "qcom,sdm845-lmh";
80 reg = <0x17d70800 0x400>;
81 interrupts = <GIC_SPI 33 IRQ_TYPE_LEVEL_HIGH>;
82 cpus = <&CPU4>;
83 qcom,lmh-temp-arm-millicelsius = <65000>;
84 qcom,lmh-temp-low-millicelsius = <94500>;
85 qcom,lmh-temp-high-millicelsius = <95000>;
86 interrupt-controller;
87 #interrupt-cells = <1>;
88 };
89

3. 한국어 전문 번역

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

Qualcomm Limits Management Hardware

1-17

이 GPL-2.0-only 또는 BSD-2-Clause YAML 스키마는 Qualcomm LMh(Limits Management Hardware)를 정의합니다. LMh는 일부 Qualcomm SoC에서 CPU 같은 IP에 대해 software가 programming한 temperature·current limit을 hardware로 강제합니다. Maintainer는 Thara Gopinath입니다.

Compatible, interrupt controller, CPU cluster

18-45

단독 `compatible`은 `qcom,sc8180x-lmh`, `qcom,sdm845-lmh`, `qcom,sm8150-lmh` 중 하나입니다. QCM2290은 `qcom,qcm2290-lmh` 뒤에 `qcom,sm8150-lmh` fallback을 둡니다. `reg`는 core register 범위 하나이고 `interrupts`는 최대 한 항목입니다.

LMh는 `#interrupt-cells = 1`인 `interrupt-controller`입니다. `cpus`는 LMh cluster의 첫 CPU를 가리키는 phandle 한 항목입니다.

Thermal FSM 세 threshold

46-60

`qcom,lmh-temp-arm-millicelsius`는 LMh thermal FSM이 engage되는 temperature threshold입니다. `qcom,lmh-temp-low-millicelsius`는 state machine이 frequency throttling 제거를 시도하는 threshold이고, `qcom,lmh-temp-high-millicelsius`는 frequency throttling을 시도하는 threshold입니다. 세 값 모두 millidegree Celsius 정수입니다.

필수 속성과 제한

61-73

`compatible`, `reg`, `interrupts`, `#interrupt-cells`, `interrupt-controller`, `cpus`와 세 temperature threshold가 모두 필수입니다. `additionalProperties: false`로 추가 속성을 금지합니다.

SDM845 LMh 예제

74-88

예제는 0x17d70800의 0x400-byte core register, GIC SPI 33 level-high interrupt와 cluster 첫 CPU인 `CPU4`를 지정합니다. FSM arm은 65000, throttling 제거 시도는 94500, throttling 시도는 95000 millidegree로 설정하고 1-cell interrupt controller로 노출합니다.

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

lmh@17d70800 {
  compatible = "qcom,sdm845-lmh";
  reg = <0x17d70800 0x400>;
  interrupts = <GIC_SPI 33 IRQ_TYPE_LEVEL_HIGH>;
  cpus = <&CPU4>;
  qcom,lmh-temp-arm-millicelsius = <65000>;
  qcom,lmh-temp-low-millicelsius = <94500>;
  qcom,lmh-temp-high-millicelsius = <95000>;
  interrupt-controller;
  #interrupt-cells = <1>;
};