Altera Arria10 System Resource Chip | Linux 6.18.37

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

1. 요약·해설

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

요약과 해설

altera-a10sr.txt:1-56

IRQ flag, GPIO pin flag와 peripheral PHY reset cell 형식을 설명합니다.

2. 영어 원문 전체

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

원문 전체 펼치기

1 * Altera Arria10 Development Kit System Resource Chip

3 Required parent device properties:

4 - compatible : "altr,a10sr"

5 - spi-max-frequency : Maximum SPI frequency.

6 - reg : The SPI Chip Select address for the Arria10

7 System Resource chip

8 - interrupts : The interrupt line the device is connected to.

9 - interrupt-controller : Marks the device node as an interrupt controller.

10 - #interrupt-cells : The number of cells to describe an IRQ, should be 2.

11 The first cell is the IRQ number.

12 The second cell is the flags, encoded as trigger

13 masks from ../interrupt-controller/interrupts.txt.

15 The A10SR consists of these sub-devices:

17 Device Description

18 ------ ----------

19 a10sr_gpio GPIO Controller

20 a10sr_rst Reset Controller

22 Arria10 GPIO

23 Required Properties:

24 - compatible : Should be "altr,a10sr-gpio"

25 - gpio-controller : Marks the device node as a GPIO Controller.

26 - #gpio-cells : Should be two. The first cell is the pin number and

27 the second cell is used to specify flags.

28 See ../gpio/gpio.txt for more information.

30 Arria10 Peripheral PHY Reset

31 Required Properties:

32 - compatible : Should be "altr,a10sr-reset"

33 - #reset-cells : Should be one.

35 Example:

37 resource-manager@0 {

38 compatible = "altr,a10sr";

39 reg = <0>;

40 spi-max-frequency = <100000>;

41 interrupt-parent = <&portb>;

42 interrupts = <5 IRQ_TYPE_LEVEL_LOW>;

43 interrupt-controller;

44 #interrupt-cells = <2>;

46 a10sr_gpio: gpio-controller {

47 compatible = "altr,a10sr-gpio";

48 gpio-controller;

49 #gpio-cells = <2>;

50 };

52 a10sr_rst: reset-controller {

53 compatible = "altr,a10sr-reset";

54 #reset-cells = <1>;

55 };

56 };

3. 한국어 전문 번역

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

Arria10 System Resource Chip

1-2

이 바인딩은 Altera Arria10 Development Kit의 System Resource Chip(A10SR)을 설명합니다.

A10SR 복합 장치

SPI chip select 0A10SR resource manager

A10SR interrupt domainParent IRQ

a10sr_gpioGPIO controller

a10sr_rstReset controller

SPI 상위 장치가 자체 interrupt domain과 GPIO 및 peripheral reset 자식을 제공합니다.

상위 SPI·인터럽트 속성

3-14

`compatible`은 `altr,a10sr`, `spi-max-frequency`는 최대 SPI 주파수, `reg`는 Arria10 System Resource Chip의 SPI chip-select 주소입니다. `interrupts`는 장치가 연결된 인터럽트 선이고 `interrupt-controller`는 이 노드를 인터럽트 컨트롤러로 표시합니다.

`#interrupt-cells`는 2여야 합니다. 첫 cell은 IRQ 번호, 둘째 cell은 `../interrupt-controller/interrupts.txt`의 trigger mask로 인코딩한 flag입니다.

GPIO와 reset 하위 장치

15-21

A10SR은 GPIO controller인 `a10sr_gpio`와 reset controller인 `a10sr_rst` 두 하위 장치로 구성됩니다.

Arria10 GPIO 필수 속성

22-29

GPIO 자식의 `compatible`은 `altr,a10sr-gpio`여야 하고 `gpio-controller`로 컨트롤러임을 표시합니다. `#gpio-cells`는 2이며 첫 cell은 pin 번호, 둘째 cell은 flag입니다. 자세한 형식은 `../gpio/gpio.txt`를 봅니다.

Peripheral PHY reset 속성

30-34

Peripheral PHY reset 자식의 `compatible`은 `altr,a10sr-reset`이어야 하고 `#reset-cells`는 1입니다.

A10SR resource manager 예제

35-56

예제는 chip-select 0에서 최대 100kHz SPI를 사용하고 port B의 interrupt 5를 active-low level로 연결합니다. A10SR interrupt specifier는 두 cell입니다.

GPIO 자식은 두 GPIO cell을, reset 자식은 하나의 reset cell을 제공하며 각각 `a10sr_gpio`, `a10sr_rst` label을 갖습니다.

resource-manager@0 {
        compatible = "altr,a10sr";
        reg = <0>;
        spi-max-frequency = <100000>;
        interrupt-parent = <&portb>;
        interrupts = <5 IRQ_TYPE_LEVEL_LOW>;
        interrupt-controller;
        #interrupt-cells = <2>;

        a10sr_gpio: gpio-controller {
                compatible = "altr,a10sr-gpio";
                gpio-controller;
                #gpio-cells = <2>;
        };

        a10sr_rst: reset-controller {
                compatible = "altr,a10sr-reset";
                #reset-cells = <1>;
        };
};