STiH407 Digital Thermal Sensor

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

1. 요약·해설

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

요약과 해설

st,stih407-thermal.yaml:1-58

STiH407 DTS의 thermal clock과 interrupt·polling 동작을 설명합니다. 접을 수 있는 영어 원문 전체는 줄 좌표를 보존하고, 한국어 전문 번역에서는 compatible·property·phandle·register·interrupt·clock·NVMEM·수치·예제 코드를 원형대로 유지합니다.

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/st,stih407-thermal.yaml#

5 $schema: http://devicetree.org/meta-schemas/core.yaml#

7 title: STMicroelectronics STi digital thermal sensor (DTS)

9 maintainers:

10 - Patrice Chotard <patrice.chotard@foss.st.com>

11 - Lee Jones <lee@kernel.org>

13 allOf:

14 - $ref: thermal-sensor.yaml

16 properties:

17 compatible:

18 const: st,stih407-thermal

20 reg:

21 maxItems: 1

23 clocks:

24 maxItems: 1

26 clock-names:

27 items:

28 - const: thermal

30 interrupts:

31 description:

32 For thermal sensors for which no interrupt has been defined, a polling

33 delay of 1000ms will be used to read the temperature from device.

34 maxItems: 1

36 '#thermal-sensor-cells':

37 const: 0

39 required:

40 - compatible

41 - reg

42 - clocks

43 - clock-names

45 unevaluatedProperties: false

47 examples:

48 - |

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

50 temperature-sensor@91a0000 {

51 compatible = "st,stih407-thermal";

52 reg = <0x91a0000 0x28>;

53 clock-names = "thermal";

54 clocks = <&CLK_SYSIN>;

55 interrupts = <GIC_SPI 205 IRQ_TYPE_EDGE_RISING>;

56 #thermal-sensor-cells = <0>;

57 };

58 ...

3. 한국어 전문 번역

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

1-15

이 GPL-2.0-only 또는 BSD-2-Clause YAML 스키마는 STMicroelectronics STi digital thermal sensor(DTS)를 정의합니다. Maintainer는 Patrice Chotard와 Lee Jones이며 공통 `thermal-sensor.yaml`을 적용합니다.

Thermal clock과 polling fallback

16-38

`compatible`은 `st,stih407-thermal`입니다. `reg`와 `clocks`는 각각 최대 한 항목이고 clock 이름은 `thermal`입니다. Interrupt가 정의되지 않은 thermal sensor는 장치 온도를 읽을 때 1000ms polling delay를 사용합니다. `interrupts`는 최대 한 항목이며 `#thermal-sensor-cells = 0`입니다.

properties:
  compatible:
    const: st,stih407-thermal

  reg:
    maxItems: 1

  clocks:
    maxItems: 1

  clock-names:
    items:
      - const: thermal

  interrupts:
    description:
      For thermal sensors for which no interrupt has been defined, a polling
      delay of 1000ms will be used to read the temperature from device.
    maxItems: 1

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

필수 속성과 제한

39-46

`compatible`, `reg`, `clocks`, `clock-names`가 필수입니다. Interrupt는 선택 사항이며 `unevaluatedProperties: false`로 추가 속성을 제한합니다.

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

unevaluatedProperties: false

STiH407 DTS 예제

47-58

예제는 `0x91a0000`의 0x28-byte DTS, `CLK_SYSIN`, GIC SPI 205 edge-rising interrupt를 연결하고 0-cell provider로 선언합니다.

  - |
    #include <dt-bindings/interrupt-controller/arm-gic.h>
    temperature-sensor@91a0000 {
        compatible = "st,stih407-thermal";
        reg = <0x91a0000 0x28>;
        clock-names = "thermal";
        clocks = <&CLK_SYSIN>;
        interrupts = <GIC_SPI 205 IRQ_TYPE_EDGE_RISING>;
        #thermal-sensor-cells = <0>;
    };
...