Lantiq SSC SPI master | Linux 6.18.37

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

1. 요약·해설

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

요약과 해설

spi-lantiq-ssc.txt:1-46

Lantiq SSC의 compatible별 interrupt 형태와 chip-select 기본값을 설명합니다. 접을 수 있는 영어 원문 전체와 줄 좌표를 보존하고, 한국어 전문 번역에서는 compatible·property·symbol·source path·timing·수치·예제 코드를 원형대로 유지합니다.

2. 영어 원문 전체

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

원문 전체 펼치기

1 Lantiq Synchronous Serial Controller (SSC) SPI master driver

3 Required properties:

4 - compatible: "lantiq,ase-spi", "lantiq,falcon-spi", "lantiq,xrx100-spi",

5 "intel,lgm-spi"

6 - #address-cells: see spi-bus.txt

7 - #size-cells: see spi-bus.txt

8 - reg: address and length of the spi master registers

9 - interrupts:

10 For compatible "intel,lgm-ssc" - the common interrupt number for

11 all of tx rx & err interrupts.

12 or

13 For rest of the compatibles, should contain the "spi_rx", "spi_tx" and

14 "spi_err" interrupt.

17 Optional properties:

18 - clocks: spi clock phandle

19 - num-cs: see spi-bus.txt, set to 8 if unset

20 - base-cs: the number of the first chip select, set to 1 if unset.

22 Example:

25 spi: spi@e100800 {

26 compatible = "lantiq,xrx200-spi", "lantiq,xrx100-spi";

27 reg = <0xE100800 0x100>;

28 interrupt-parent = <&icu0>;

29 interrupts = <22 23 24>;

30 interrupt-names = "spi_rx", "spi_tx", "spi_err";

31 #address-cells = <1>;

32 #size-cells = <1>;

33 num-cs = <6>;

34 base-cs = <1>;

35 };

37 ssc0: spi@e0800000 {

38 compatible = "intel,lgm-spi";

39 reg = <0xe0800000 0x400>;

40 interrupt-parent = <&ioapic1>;

41 interrupts = <35 1>;

42 #address-cells = <1>;

43 #size-cells = <0>;

44 clocks = <&cgu0 LGM_CLK_NGI>, <&cgu0 LGM_GCLK_SSC0>;

45 clock-names = "freq", "gate";

46 };

3. 한국어 전문 번역

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

Lantiq SSC 필수 속성과 interrupt 형태

1-16

이 문서는 Lantiq Synchronous Serial Controller(SSC) SPI master driver binding을 설명합니다. Compatible 목록은 `lantiq,ase-spi`, `lantiq,falcon-spi`, `lantiq,xrx100-spi`, `intel,lgm-spi`입니다. `#address-cells`와 `#size-cells`는 이동 전 `spi-bus.txt`를 참조하고 `reg`는 SPI master register 주소와 길이입니다.

원문 interrupt 조건은 `intel,lgm-ssc` compatible에 TX·RX·error 공통 interrupt 하나를 사용한다고 적습니다. 그러나 compatible 목록과 예제는 `intel,lgm-spi`를 사용하므로 두 literal의 문서 내 표기 차이를 그대로 보존합니다. 나머지 compatible은 `spi_rx`, `spi_tx`, `spi_err` interrupt를 각각 제공합니다.

Clock과 chip-select 기본값

17-21

선택 속성 `clocks`는 SPI clock phandle입니다. `num-cs`는 지정하지 않으면 8이고 `base-cs`는 첫 chip-select 번호이며 기본값은 1입니다.

XRX200과 Intel LGM 예제

22-46

첫 예제는 `lantiq,xrx200-spi`와 fallback `lantiq,xrx100-spi`, RX/TX/error interrupt 22·23·24, chip-select 6개와 base 1을 사용합니다.

spi: spi@e100800 {
        compatible = "lantiq,xrx200-spi", "lantiq,xrx100-spi";
        reg = <0xE100800 0x100>;
        interrupt-parent = <&icu0>;
        interrupts = <22 23 24>;
        interrupt-names = "spi_rx", "spi_tx", "spi_err";
        #address-cells = <1>;
        #size-cells = <1>;
        num-cs = <6>;
        base-cs = <1>;
};

둘째 예제는 `intel,lgm-spi`, IOAPIC interrupt 35, frequency·gate clock 두 개와 이름 `freq`, `gate`를 사용합니다.

ssc0: spi@e0800000 {
        compatible = "intel,lgm-spi";
        reg = <0xe0800000 0x400>;
        interrupt-parent = <&ioapic1>;
        interrupts = <35 1>;
        #address-cells = <1>;
        #size-cells = <0>;
        clocks = <&cgu0 LGM_CLK_NGI>, <&cgu0 LGM_GCLK_SSC0>;
        clock-names = "freq", "gate";
};