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 이름, 코드 심벌, 소스 경로는 원문 표기를 유지합니다.

1. 요약·해설

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

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 <[email protected]>
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. 한국어 전문 번역

영어 원문의 문단 순서와 의미에 맞춰 전체 내용을 번역했습니다. 코드, 함수명, 코드 심벌, 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>;
};