Microchip PIC32 SPI master | Linux 6.18.37

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

1. 요약·해설

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

요약과 해설

microchip,spi-pic32.txt:1-34

PIC32 SPI master의 interrupt 순서, clock, chip-select와 DMA를 설명합니다. 접을 수 있는 영어 원문 전체와 줄 좌표를 보존하고, 한국어 전문 번역에서는 compatible·property·phandle·interrupt/DMA 순서·수치·예제 코드를 원형대로 유지합니다.

2. 영어 원문 전체

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

원문 전체 펼치기

1 Microchip PIC32 SPI Master controller

3 Required properties:

4 - compatible: Should be "microchip,pic32mzda-spi".

5 - reg: Address and length of register space for the device.

6 - interrupts: Should contain all three spi interrupts in sequence

7 of <fault-irq>, <receive-irq>, <transmit-irq>.

8 - interrupt-names: Should be "fault", "rx", "tx" in order.

9 - clocks: Phandle of the clock generating SPI clock on the bus.

10 - clock-names: Should be "mck0".

11 - cs-gpios: Specifies the gpio pins to be used for chipselects.

12 See: Documentation/devicetree/bindings/spi/spi-bus.txt

14 Optional properties:

15 - dmas: Two or more DMA channel specifiers following the convention outlined

16 in Documentation/devicetree/bindings/dma/dma.txt

17 - dma-names: Names for the dma channels. There must be at least one channel

18 named "spi-tx" for transmit and named "spi-rx" for receive.

20 Example:

22 spi1: spi@1f821000 {

23 compatible = "microchip,pic32mzda-spi";

24 reg = <0x1f821000 0x200>;

25 interrupts = <109 IRQ_TYPE_LEVEL_HIGH>,

26 <110 IRQ_TYPE_LEVEL_HIGH>,

27 <111 IRQ_TYPE_LEVEL_HIGH>;

28 interrupt-names = "fault", "rx", "tx";

29 clocks = <&PBCLK2>;

30 clock-names = "mck0";

31 cs-gpios = <&gpio3 4 GPIO_ACTIVE_LOW>;

32 dmas = <&dma 134>, <&dma 135>;

33 dma-names = "spi-rx", "spi-tx";

34 };

3. 한국어 전문 번역

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

PIC32 SPI master 필수 속성

1-13

Microchip PIC32 SPI master의 `compatible`은 `microchip,pic32mzda-spi`입니다. `reg`는 register 공간의 address와 length를 지정합니다.

`interrupts`는 fault, receive, transmit interrupt 세 개를 이 순서로 담고 `interrupt-names`는 같은 순서로 `fault`, `rx`, `tx`여야 합니다.

`clocks`는 SPI bus clock을 생성하는 clock phandle이고 `clock-names`는 `mck0`입니다. `cs-gpios`는 chip-select에 사용할 GPIO pin을 지정하며 자세한 내용은 `Documentation/devicetree/bindings/spi/spi-bus.txt`를 참조합니다.

선택적 DMA channel

14-19

`dmas`는 `Documentation/devicetree/bindings/dma/dma.txt` 규칙을 따르는 두 개 이상의 DMA channel specifier입니다. `dma-names`에는 transmit용 `spi-tx`와 receive용 `spi-rx`가 각각 최소 하나 있어야 합니다.

PIC32 SPI1 예제

20-34

예제는 address `0x1f821000`, fault/RX/TX interrupt 109~111, PBCLK2, active-low chip-select GPIO와 RX/TX DMA channel 134·135를 연결합니다.

spi1: spi@1f821000 {
        compatible = "microchip,pic32mzda-spi";
        reg = <0x1f821000 0x200>;
        interrupts = <109 IRQ_TYPE_LEVEL_HIGH>,
                     <110 IRQ_TYPE_LEVEL_HIGH>,
                     <111 IRQ_TYPE_LEVEL_HIGH>;
        interrupt-names = "fault", "rx", "tx";
        clocks = <&PBCLK2>;
        clock-names = "mck0";
        cs-gpios = <&gpio3 4 GPIO_ACTIVE_LOW>;
        dmas = <&dma 134>, <&dma 135>;
        dma-names = "spi-rx", "spi-tx";
};