Broadcom Broadband SoC Timer

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

1. 요약·해설

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

요약과 해설

brcm,bcmbca-timer.yaml:1-40

Broadcom 구형 3-timer와 신형 4-timer block의 차이를 설명합니다. 접을 수 있는 영어 원문 전체와 한국어 전문 번역을 함께 제공하며 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/timer/brcm,bcmbca-timer.yaml#

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

7 title: Broadcom Broadband SoC timer

9 maintainers:

10 - Rafał Miłecki <rafal@milecki.pl>

12 properties:

13 compatible:

14 oneOf:

15 - const: brcm,bcm6345-timer

16 description: >

17 An old block with 3 timers.

19 It can be found in BCM6345, BCM6838 and BCM63268.

20 - const: brcm,bcm63138-timer

21 description: >

22 Updated block with 4 timers and control regs at the beginning.

24 It can be found in newer SoCs, e.g. BCM63138, BCM63148, BCM63381,

25 BCM68360, BCM6848, BCM6858, BCM4908.

27 reg:

28 maxItems: 1

30 additionalProperties: false

32 required:

33 - reg

35 examples:

36 - |

37 timer@fffe0200 {

38 compatible = "brcm,bcm6345-timer";

39 reg = <0xfffe0200 0x1c>;

40 };

3. 한국어 전문 번역

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

1-11

GPL-2.0-only 또는 BSD-2-Clause 라이선스의 이 스키마는 Broadcom Broadband SoC timer를 정의합니다. Maintainer는 Rafał Miłecki입니다.

구형 3-timer와 신형 4-timer block

12-34

`brcm,bcm6345-timer`는 timer 세 개를 가진 구형 block으로 BCM6345, BCM6838, BCM63268에서 사용됩니다. `brcm,bcm63138-timer`는 앞부분에 control register를 두고 timer 네 개를 가진 갱신된 block이며 BCM63138, BCM63148, BCM63381, BCM68360, BCM6848, BCM6858, BCM4908 같은 신형 SoC에 있습니다. `reg`는 최대 한 항목이자 유일한 필수 속성이고 추가 속성은 허용되지 않습니다.

properties:
  compatible:
    oneOf:
      - const: brcm,bcm6345-timer
        description: >
          An old block with 3 timers.

          It can be found in BCM6345, BCM6838 and BCM63268.
      - const: brcm,bcm63138-timer
        description: >
          Updated block with 4 timers and control regs at the beginning.

          It can be found in newer SoCs, e.g. BCM63138, BCM63148, BCM63381,
          BCM68360, BCM6848, BCM6858, BCM4908.

  reg:
    maxItems: 1

additionalProperties: false

required:
  - reg

BCM6345 timer 예제

35-40

예제는 `timer@fffe0200`에 `brcm,bcm6345-timer` compatible과 0x1c-byte register 영역을 지정합니다.

- |
  timer@fffe0200 {
    compatible = "brcm,bcm6345-timer";
    reg = <0xfffe0200 0x1c>;
  };