HTE Consumer

요약·해설, 영어 원문, 전체 번역을 구분해 실었습니다. API 이름, 코드 심벌, 소스 경로는 원문 표기를 유지합니다.

1. 요약·해설

원문의 핵심 내용을 정리하고 커널 프로그래밍에 필요한 설명을 덧붙였습니다. 아래의 전체 번역과는 별도로 작성한 해설입니다.

요약과 해설

hte-consumer.yaml:1-39

HTE consumer의 provider phandle·line identifier 형식을 설명합니다. 접을 수 있는 영어 원문 전체와 한국어 전문 번역을 함께 제공하며 compatible, interrupt, clock, register, phandle, 수치와 줄 좌표를 원형대로 보존합니다.

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/timestamp/hte-consumer.yaml#

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

7 title: HTE Consumer

9 maintainers:

10 - Dipen Patel <[email protected]>

12 select: true

14 properties:

15 timestamps:

16 $ref: /schemas/types.yaml#/definitions/phandle-array

17 description:

18 The list of HTE provider phandle. The first cell must represent the

19 provider phandle followed by the line identifiers. The meaning of the

20 line identifier and exact number of arguments must be specified in the

21 HTE provider device tree binding document.

23 timestamp-names:

24 $ref: /schemas/types.yaml#/definitions/string-array

25 description:

26 An optional string property to label each line specifier present in the

27 timestamp property.

29 dependencies:

30 timestamp-names: [ timestamps ]

32 additionalProperties: true

34 examples:

35 - |

36 hte_tegra_consumer {

37 timestamps = <&tegra_hte_aon 0x9>, <&tegra_hte_lic 0x19>;

38 timestamp-names = "hte-gpio", "hte-i2c";

39 };

3. 한국어 전문 번역

영어 원문의 문단 순서와 의미에 맞춰 전체 내용을 번역했습니다. 코드, 함수명, 코드 심벌, URL은 원문 표기를 유지합니다.

1-13

GPL-2.0-only 또는 BSD-2-Clause 라이선스의 이 선택 스키마는 HTE consumer를 정의하며 모든 node에 적용될 수 있도록 `select: true`를 사용합니다. Maintainer는 Dipen Patel입니다.

Provider phandle와 line identifier

14-33

`timestamps`는 HTE provider phandle array입니다. 각 specifier의 첫 cell은 provider phandle이고 뒤에는 line identifier가 옵니다. Line identifier의 의미와 정확한 argument 수는 해당 HTE provider의 device tree binding에서 정의해야 합니다. 선택적인 `timestamp-names` string array는 `timestamps`에 있는 각 line specifier에 label을 붙입니다. `timestamp-names`를 사용하려면 `timestamps`도 반드시 있어야 하며 다른 consumer 속성은 허용됩니다.

properties:
  timestamps:
    $ref: /schemas/types.yaml#/definitions/phandle-array
    description:
      The list of HTE provider phandle. The first cell must represent the
      provider phandle followed by the line identifiers. The meaning of the
      line identifier and exact number of arguments must be specified in the
      HTE provider device tree binding document.

  timestamp-names:
    $ref: /schemas/types.yaml#/definitions/string-array
    description:
      An optional string property to label each line specifier present in the
      timestamp property.

dependencies:
  timestamp-names: [ timestamps ]

additionalProperties: true

GPIO·I2C timestamp consumer

34-39

예제 `hte_tegra_consumer`는 AON HTE line 0x9와 LIC HTE line 0x19를 각각 `hte-gpio`, `hte-i2c`라는 이름으로 참조합니다.

examples:
  - |
    hte_tegra_consumer {
              timestamps = <&tegra_hte_aon 0x9>, <&tegra_hte_lic 0x19>;
              timestamp-names = "hte-gpio", "hte-i2c";
    };