Documentation/devicetree/bindings/spi/jcore,spi.txt GitHub 원문 ↗

Linux 6.18.37 · Devicetree Bindings / SPI

J-Core SPI master

J-Core SPI master의 register와 선택적 reference clock을 설명합니다.

Source pathDocumentation/devicetree/bindings/spi/jcore,spi.txt
Source versionLinux v6.18.37
TranslationDUJINLABS 전문 번역 + 해설

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

1. 요약·해설

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

요약과 해설

jcore,spi.txt:1-34

J-Core SPI master의 register와 선택적 reference clock을 설명합니다. 접을 수 있는 영어 원문 전체와 줄 좌표를 보존하고, 한국어 전문 번역에서는 compatible·property·phandle·수치·예제 코드를 원형대로 유지합니다.

2. 영어 원문 전체

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

원문 전체 펼치기
1 J-Core SPI master
2
3 Required properties:
4
5 - compatible: Must be "jcore,spi2".
6
7 - reg: Memory region for registers.
8
9 - #address-cells: Must be 1.
10
11 - #size-cells: Must be 0.
12
13 Optional properties:
14
15 - clocks: If a phandle named "ref_clk" is present, SPI clock speed
16 programming is relative to the frequency of the indicated clock.
17 Necessary only if the input clock rate is something other than a
18 fixed 50 MHz.
19
20 - clock-names: Clock names, one for each phandle in clocks.
21
22 See spi-bus.txt for additional properties not specific to this device.
23
24 Example:
25
26 spi@40 {
27 compatible = "jcore,spi2";
28 #address-cells = <1>;
29 #size-cells = <0>;
30 reg = <0x40 0x8>;
31 spi-max-frequency = <25000000>;
32 clocks = <&bus_clk>;
33 clock-names = "ref_clk";
34 }
35

3. 한국어 전문 번역

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

J-Core SPI master 필수 속성

1-12

J-Core SPI master의 `compatible`은 `jcore,spi2`여야 합니다. `reg`는 register memory 영역을 지정하고 `#address-cells`는 1, `#size-cells`는 0이어야 합니다.

선택적 reference clock

13-23

`clocks`에 `ref_clk`라는 phandle이 있으면 SPI clock speed programming은 해당 clock 주파수를 기준으로 합니다. 입력 clock이 고정 50MHz가 아닐 때만 필요합니다. `clock-names`는 `clocks`의 각 phandle에 대응하는 이름을 제공합니다.

장치에 특화되지 않은 추가 속성은 `spi-bus.txt`를 참조합니다.

J-Core SPI 예제

24-34

예제는 register 영역 `0x40`부터 8 byte, 최대 SPI 주파수 25MHz, `bus_clk`를 `ref_clk`로 사용하는 controller를 선언합니다.

spi@40 {
        compatible = "jcore,spi2";
        #address-cells = <1>;
        #size-cells = <0>;
        reg = <0x40 0x8>;
        spi-max-frequency = <25000000>;
        clocks = <&bus_clk>;
        clock-names = "ref_clk";
}