IMG SPFI controller | Linux 6.18.37

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

1. 요약·해설

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

요약과 해설

spi-img-spfi.txt:1-39

IMG SPFI의 clock·DMA 이름, quad mode와 최대 주파수를 설명합니다. 접을 수 있는 영어 원문 전체와 줄 좌표를 보존하고, 한국어 전문 번역에서는 compatible·property·symbol·source path·timing·수치·예제 코드를 원형대로 유지합니다.

2. 영어 원문 전체

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

원문 전체 펼치기

1 IMG Synchronous Peripheral Flash Interface (SPFI) controller

3 Required properties:

4 - compatible: Must be "img,spfi".

5 - reg: Must contain the base address and length of the SPFI registers.

6 - interrupts: Must contain the SPFI interrupt.

7 - clocks: Must contain an entry for each entry in clock-names.

8 See ../clock/clock-bindings.txt for details.

9 - clock-names: Must include the following entries:

10 - spfi: SPI operating clock

11 - sys: SPI system interface clock

12 - dmas: Must contain an entry for each entry in dma-names.

13 See ../dma/dma.txt for details.

14 - dma-names: Must include the following entries:

15 - rx

16 - tx

17 - cs-gpios: Must specify the GPIOs used for chipselect lines.

18 - #address-cells: Must be 1.

19 - #size-cells: Must be 0.

21 Optional properties:

22 - img,supports-quad-mode: Should be set if the interface supports quad mode

23 SPI transfers.

24 - spfi-max-frequency: Maximum speed supported by the spfi block.

26 Example:

28 spi@18100f00 {

29 compatible = "img,spfi";

30 reg = <0x18100f00 0x100>;

31 interrupts = <GIC_SHARED 22 IRQ_TYPE_LEVEL_HIGH>;

32 clocks = <&spi_clk>, <&system_clk>;

33 clock-names = "spfi", "sys";

34 dmas = <&mdc 9 0xffffffff 0>, <&mdc 10 0xffffffff 0>;

35 dma-names = "rx", "tx";

37 #address-cells = <1>;

38 #size-cells = <0>;

39 };

3. 한국어 전문 번역

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

IMG SPFI 필수 자원

1-20

이 문서는 IMG Synchronous Peripheral Flash Interface(SPFI) controller를 설명합니다. `compatible`은 `img,spfi`, `reg`는 SPFI register의 base address와 length, `interrupts`는 SPFI interrupt입니다.

`clocks`는 `clock-names`의 각 항목에 대응하고 이름은 SPI operating clock `spfi`, system interface clock `sys`입니다. `dmas`도 `dma-names`와 1:1로 대응하며 이름은 `rx`, `tx` 순서입니다.

`cs-gpios`는 chip-select line용 GPIO를 지정합니다. `#address-cells`는 1, `#size-cells`는 0입니다. Clock 상세 참조는 `../clock/clock-bindings.txt`, DMA 참조는 `../dma/dma.txt`입니다.

Quad mode와 최대 주파수

21-25

선택 속성 `img,supports-quad-mode`는 interface가 quad-mode SPI transfer를 지원할 때 설정합니다. `spfi-max-frequency`는 SPFI block이 지원하는 최대 속도입니다.

SPFI clock·DMA 예제

26-39

예제의 `spi@18100f00`은 `img,spfi`, GIC shared interrupt 22, `spfi`·`sys` clock과 MDC RX/TX DMA channel 9·10을 사용합니다.

spi@18100f00 {
        compatible = "img,spfi";
        reg = <0x18100f00 0x100>;
        interrupts = <GIC_SHARED 22 IRQ_TYPE_LEVEL_HIGH>;
        clocks = <&spi_clk>, <&system_clk>;
        clock-names = "spfi", "sys";
        dmas = <&mdc 9 0xffffffff 0>, <&mdc 10 0xffffffff 0>;
        dma-names = "rx", "tx";

        #address-cells = <1>;
        #size-cells = <0>;
};