Cirrus Logic CL-PS71xx SPI binding | Linux 6.18.37

요약·해설, 영어 원문, 전체 번역을 구분해 실었습니다. API 이름, 코드 심벌, 소스 경로는 원문 표기를 유지합니다.

1. 요약·해설

원문의 핵심 내용을 정리하고 커널 프로그래밍에 필요한 설명을 덧붙였습니다. 아래의 전체 번역과는 별도로 작성한 해설입니다.

요약과 해설

spi-clps711x.txt:1-32

CL-PS71xx SPI의 필수 자원과 EP7209 syscon3 연계를 설명합니다. 접을 수 있는 영어 원문 전체와 줄 좌표를 보존하고, 한국어 전문 번역에서는 compatible·property·symbol·source path·표·수치·조건부 제약·예제 코드를 원형대로 유지합니다.

2. 영어 원문 전체

번역에 사용한 Linux v6.18.37 원문입니다. 줄 번호는 해당 버전의 소스 파일을 기준으로 합니다.

원문 전체 펼치기

1 Serial Peripheral Interface on Cirrus Logic CL-PS71xx, EP72xx, EP73xx

3 Required properties

4 - #address-cells: must be <1>

5 - #size-cells: must be <0>

6 - compatible: should include "cirrus,ep7209-spi"

7 - reg: Address and length of one register range

8 - interrupts: one interrupt line

9 - clocks: One entry, refers to the SPI bus clock

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

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

13 An additional register is present in the system controller,

14 which is assumed to be in the same device tree, with and marked

15 as compatible with "cirrus,ep7209-syscon3".

17 Example:

19 spi@80000500 {

20 #address-cells = <1>;

21 #size-cells = <0>;

22 compatible = "cirrus,ep7209-spi";

23 reg = <0x80000500 0x4>;

24 interrupts = <15>;

25 clocks = <&clks CLPS711X_CLK_SPI>;

26 };

28 syscon3: syscon@80002200 {

29 compatible = "cirrus,ep7209-syscon3", "syscon";

30 reg = <0x80002200 0x40>;

31 };

3. 한국어 전문 번역

영어 원문의 문단 순서와 의미에 맞춰 전체 내용을 번역했습니다. 코드, 함수명, 코드 심벌, URL은 원문 표기를 유지합니다.

CL-PS71xx SPI와 syscon 요구사항

1-16

이 문서는 Cirrus Logic CL-PS71xx, EP72xx, EP73xx의 SPI를 설명합니다. `#address-cells`는 1, `#size-cells`는 0이고 `compatible`에는 `cirrus,ep7209-spi`가 포함되어야 합니다.

`reg`는 하나의 register range 주소와 길이, `interrupts`는 interrupt line 하나, `clocks`는 SPI bus clock 한 항목입니다. `cs-gpios`는 chip-select용 GPIO pin을 지정합니다. 원문 참조 경로 `Documentation/devicetree/bindings/spi/spi-bus.txt`의 내용은 현재 `spi-controller.yaml`로 이동했습니다.

추가 register는 같은 device tree의 system controller에 있으며 그 node는 `cirrus,ep7209-syscon3` compatible로 표시되어야 합니다.

EP7209 SPI와 syscon3 예제

17-32

예제는 `spi@80000500`에 4-byte register, interrupt 15와 `CLPS711X_CLK_SPI` clock을 지정합니다. `syscon3: syscon@80002200`은 `cirrus,ep7209-syscon3`과 `syscon` compatible, register 길이 `0x40`을 사용합니다.

spi@80000500 {
        #address-cells = <1>;
        #size-cells = <0>;
        compatible = "cirrus,ep7209-spi";
        reg = <0x80000500 0x4>;
        interrupts = <15>;
        clocks = <&clks CLPS711X_CLK_SPI>;
};

syscon3: syscon@80002200 {
        compatible = "cirrus,ep7209-syscon3", "syscon";
        reg = <0x80002200 0x40>;
};