← Documents Documentation/devicetree/bindings/spi/ralink,mt7621-spi.yaml GitHub 원문 ↗

Linux 6.18.37 · Devicetree Bindings / SPI

MediaTek MT7621/MT7628 SPI controller

MT7621/MT7628 SPI의 clock·reset과 pinctrl 예제를 설명합니다.

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

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

1. 요약·해설

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

2. 영어 원문 전체

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

원문 전체 펼치기
1 # SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2 %YAML 1.2
3 ---
4 $id: http://devicetree.org/schemas/spi/ralink,mt7621-spi.yaml#
5 $schema: http://devicetree.org/meta-schemas/core.yaml#
6
7 maintainers:
8 - Sergio Paracuellos <sergio.paracuellos@gmail.com>
9
10 title: Mediatek MT7621/MT7628 SPI controller
11
12 allOf:
13 - $ref: /schemas/spi/spi-controller.yaml#
14
15 properties:
16 compatible:
17 const: ralink,mt7621-spi
18
19 reg:
20 maxItems: 1
21
22 clocks:
23 maxItems: 1
24
25 clock-names:
26 const: spi
27
28 resets:
29 maxItems: 1
30
31 reset-names:
32 const: spi
33
34 required:
35 - compatible
36 - reg
37 - resets
38 - "#address-cells"
39 - "#size-cells"
40
41 unevaluatedProperties: false
42
43 examples:
44 - |
45 #include <dt-bindings/clock/mt7621-clk.h>
46 #include <dt-bindings/reset/mt7621-reset.h>
47
48 spi@b00 {
49 compatible = "ralink,mt7621-spi";
50 reg = <0xb00 0x100>;
51 clocks = <&sysc MT7621_CLK_SPI>;
52 clock-names = "spi";
53 resets = <&sysc MT7621_RST_SPI>;
54 reset-names = "spi";
55
56 #address-cells = <1>;
57 #size-cells = <0>;
58
59 pinctrl-names = "default";
60 pinctrl-0 = <&spi_pins>;
61 };
62

3. 한국어 전문 번역

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

MediaTek MT7621/MT7628 SPI schema

1-14

이 GPL-2.0-only 또는 BSD-2-Clause YAML schema는 MediaTek MT7621/MT7628 SPI controller를 정의합니다. Schema ID는 `http://devicetree.org/schemas/spi/ralink,mt7621-spi.yaml#`, maintainer는 Sergio Paracuellos입니다.

공통 `/schemas/spi/spi-controller.yaml#`의 SPI controller 속성을 상속합니다.

Compatible, clock과 reset

15-33

`compatible`은 `ralink,mt7621-spi`로 고정되고 `reg`, `clocks`, `resets`는 각각 최대 한 항목입니다.

`clock-names`와 `reset-names`는 모두 `spi`로 고정됩니다. Clock specifier와 reset specifier를 사용할 때 각 이름이 이 값과 일치해야 합니다.

필수 속성과 추가 속성 제한

34-42

필수 속성은 `compatible`, `reg`, `resets`, `#address-cells`, `#size-cells`입니다. `clocks`, `clock-names`, `reset-names`는 schema에 정의되어 있지만 필수 목록에는 포함되지 않습니다. `unevaluatedProperties: false`로 평가되지 않은 추가 속성을 금지합니다.

MT7621 SPI 예제

43-61

예제는 `spi@b00`에 register `<0xb00 0x100>`, `MT7621_CLK_SPI` clock과 `MT7621_RST_SPI` reset을 연결합니다. Clock과 reset 이름은 모두 `spi`이며 기본 pinctrl은 `spi_pins`입니다.

#include <dt-bindings/clock/mt7621-clk.h>
#include <dt-bindings/reset/mt7621-reset.h>

spi@b00 {
  compatible = "ralink,mt7621-spi";
  reg = <0xb00 0x100>;
  clocks = <&sysc MT7621_CLK_SPI>;
  clock-names = "spi";
  resets = <&sysc MT7621_RST_SPI>;
  reset-names = "spi";

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

  pinctrl-names = "default";
  pinctrl-0 = <&spi_pins>;
};