요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
1
J-Core SPI master
3
Required properties:
5
- compatible: Must be "jcore,spi2".
7
- reg: Memory region for registers.
9
- #address-cells: Must be 1.
11
- #size-cells: Must be 0.
13
Optional properties:
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.
20
- clock-names: Clock names, one for each phandle in clocks.
22
See spi-bus.txt for additional properties not specific to this device.
24
Example:
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
}
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
J-Core SPI master 필수 속성
1-12J-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";
}
요약과 해설
jcore,spi.txt:1-34J-Core SPI master의 register와 선택적 reference clock을 설명합니다. 접을 수 있는 영어 원문 전체와 줄 좌표를 보존하고, 한국어 전문 번역에서는 compatible·property·phandle·수치·예제 코드를 원형대로 유지합니다.