← Documents Documentation/devicetree/bindings/spi/spi-sunplus-sp7021.yaml GitHub 원문 ↗

Linux 6.18.37 · Devicetree Bindings / SPI

Sunplus SP7021 SPI controller

SP7021 SPI의 master·slave register와 세 interrupt, pinctrl 요구사항을 설명합니다.

Source pathDocumentation/devicetree/bindings/spi/spi-sunplus-sp7021.yaml
Source versionLinux v6.18.37
TranslationDUJINLABS 전문 번역 + 해설

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

1. 요약·해설

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

요약과 해설

spi-sunplus-sp7021.yaml:1-78

SP7021 SPI의 master·slave register와 세 interrupt, pinctrl 요구사항을 설명합니다. 접을 수 있는 영어 원문 전체와 줄 좌표를 보존하고, 한국어 전문 번역에서는 compatible·property·symbol·source path·URL·수치·예제 코드를 원형대로 유지합니다.

2. 영어 원문 전체

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

원문 전체 펼치기
1 # SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
2 # Copyright (C) Sunplus Co., Ltd. 2021
3 %YAML 1.2
4 ---
5 $id: http://devicetree.org/schemas/spi/spi-sunplus-sp7021.yaml#
6 $schema: http://devicetree.org/meta-schemas/core.yaml#
7
8 title: Sunplus sp7021 SPI controller
9
10 allOf:
11 - $ref: spi-controller.yaml
12
13 maintainers:
14 - Li-hao Kuo <lhjeff911@gmail.com>
15
16 properties:
17 compatible:
18 enum:
19 - sunplus,sp7021-spi
20
21 reg:
22 items:
23 - description: the SPI master registers
24 - description: the SPI slave registers
25
26 reg-names:
27 items:
28 - const: master
29 - const: slave
30
31 interrupt-names:
32 items:
33 - const: dma_w
34 - const: master_risc
35 - const: slave_risc
36
37 interrupts:
38 minItems: 3
39
40 clocks:
41 maxItems: 1
42
43 resets:
44 maxItems: 1
45
46 required:
47 - compatible
48 - reg
49 - reg-names
50 - interrupts
51 - interrupt-names
52 - clocks
53 - resets
54 - pinctrl-names
55 - pinctrl-0
56
57 unevaluatedProperties: false
58
59 examples:
60 - |
61 #include <dt-bindings/interrupt-controller/irq.h>
62 spi@9c002d80 {
63 compatible = "sunplus,sp7021-spi";
64 reg = <0x9c002d80 0x80>, <0x9c002e00 0x80>;
65 reg-names = "master", "slave";
66 interrupt-parent = <&intc>;
67 interrupt-names = "dma_w",
68 "master_risc",
69 "slave_risc";
70 interrupts = <144 IRQ_TYPE_LEVEL_HIGH>,
71 <146 IRQ_TYPE_LEVEL_HIGH>,
72 <145 IRQ_TYPE_LEVEL_HIGH>;
73 clocks = <&clkc 0x32>;
74 resets = <&rstc 0x22>;
75 pinctrl-names = "default";
76 pinctrl-0 = <&pins_spi0>;
77 };
78 ...
79

3. 한국어 전문 번역

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

Sunplus SP7021 SPI schema

1-15

이 GPL-2.0 또는 BSD-2-Clause YAML schema는 Sunplus SP7021 SPI controller를 정의합니다. 저작권 표기는 Sunplus Co., Ltd. 2021이며 공통 `spi-controller.yaml`을 상속하고 maintainer는 Li-hao Kuo입니다.

Master·slave register 영역

16-30

`compatible`은 `sunplus,sp7021-spi`입니다. `reg`는 SPI master register와 SPI slave register 두 항목이고 `reg-names`는 같은 순서로 `master`, `slave`입니다.

세 interrupt와 clock·reset

31-45

`interrupt-names`는 DMA write용 `dma_w`, master RISC용 `master_risc`, slave RISC용 `slave_risc` 순서입니다. `interrupts`는 최소 세 항목이며 `clocks`와 `resets`는 각각 최대 한 항목입니다.

필수 pinctrl과 추가 속성 제한

46-58

필수 속성은 `compatible`, `reg`, `reg-names`, `interrupts`, `interrupt-names`, `clocks`, `resets`, `pinctrl-names`, `pinctrl-0`입니다. `unevaluatedProperties: false`로 평가되지 않은 추가 속성을 금지합니다.

SP7021 master·slave와 interrupt 예제

59-78

예제의 `spi@9c002d80`은 master와 slave에 각각 0x80 크기 register 영역을 할당합니다. Interrupt 144·146·145를 `dma_w`, `master_risc`, `slave_risc` 순서로 연결하고 clock 0x32, reset 0x22, 기본 `pins_spi0` pinctrl을 사용합니다.

    #include <dt-bindings/interrupt-controller/irq.h>
    spi@9c002d80 {
        compatible = "sunplus,sp7021-spi";
        reg = <0x9c002d80 0x80>, <0x9c002e00 0x80>;
        reg-names = "master", "slave";
        interrupt-parent = <&intc>;
        interrupt-names = "dma_w",
                          "master_risc",
                          "slave_risc";
        interrupts = <144 IRQ_TYPE_LEVEL_HIGH>,
                     <146 IRQ_TYPE_LEVEL_HIGH>,
                     <145 IRQ_TYPE_LEVEL_HIGH>;
        clocks = <&clkc 0x32>;
        resets = <&rstc 0x22>;
        pinctrl-names = "default";
        pinctrl-0 = <&pins_spi0>;
    };
...