HTE Consumer

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

1. 요약·해설

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

요약과 해설

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. 한국어 전문 번역

영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 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";
    };