요약·해설, 영어 원문, 전체 번역을 구분해 실었습니다. API 이름, 코드 심벌, 소스 경로는 원문 표기를 유지합니다.
1. 요약·해설
원문의 핵심 내용을 정리하고 커널 프로그래밍에 필요한 설명을 덧붙였습니다. 아래의 전체 번역과는 별도로 작성한 해설입니다.
2. 영어 원문 전체
번역에 사용한 Linux v6.18.37 원문입니다. 줄 번호는 해당 버전의 소스 파일을 기준으로 합니다.
원문 전체 펼치기
FLCTL NAND controller
Required properties:
- compatible : "renesas,shmobile-flctl-sh7372"
- reg : Address range of the FLCTL
- interrupts : flste IRQ number
- nand-bus-width : bus width to NAND chip
Optional properties:
- dmas: DMA specifier(s)
- dma-names: name for each DMA specifier. Valid names are
"data_tx", "data_rx", "ecc_tx", "ecc_rx"
The DMA fields are not used yet in the driver but are listed here for
completing the bindings.
The device tree may optionally contain sub-nodes describing partitions of the
address space. See mtd.yaml for more detail.
Example:
flctl@e6a30000 {
#address-cells = <1>;
#size-cells = <1>;
compatible = "renesas,shmobile-flctl-sh7372";
reg = <0xe6a30000 0x100>;
interrupts = <0x0d80>;
nand-bus-width = <16>;
dmas = <&dmac 1 /* data_tx */
&dmac 2;> /* data_rx */
dma-names = "data_tx", "data_rx";
system@0 {
label = "system";
reg = <0x0 0x8000000>;
};
userdata@8000000 {
label = "userdata";
reg = <0x8000000 0x10000000>;
};
cache@18000000 {
label = "cache";
reg = <0x18000000 0x8000000>;
};
};
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미에 맞춰 전체 내용을 번역했습니다. 코드, 함수명, 코드 심벌, URL은 원문 표기를 유지합니다.
Renesas FLCTL NAND controller
1-2이 문서는 FLCTL NAND controller 바인딩입니다.
Bus·interrupt·DMA와 partition
3-19필수 `compatible`은 `renesas,shmobile-flctl-sh7372`입니다. `reg`는 FLCTL address 범위, `interrupts`는 `flste` IRQ 번호, `nand-bus-width`는 NAND chip의 bus width입니다.
선택 `dmas`에는 DMA specifier를 넣고 `dma-names`에는 각 specifier의 이름을 넣습니다. 유효한 이름은 `data_tx`, `data_rx`, `ecc_tx`, `ecc_rx`입니다.
Driver는 아직 DMA field를 사용하지 않지만 바인딩을 완성하기 위해 목록에 포함되어 있습니다. Device tree에는 address space partition을 설명하는 subnode를 선택적으로 둘 수 있으며 자세한 형식은 `mtd.yaml`을 따릅니다.
Data path와 ECC path의 송수신 channel을 구분합니다.
16-bit FLCTL과 세 partition
20-49예제는 `0xe6a30000`의 FLCTL에 interrupt `0x0d80`, 16-bit NAND bus와 data TX·RX DMA를 지정합니다. Address space는 `system`, `userdata`, `cache`의 세 partition으로 나뉩니다.
예제의 연속 address 영역입니다.
flctl@e6a30000 {
#address-cells = <1>;
#size-cells = <1>;
compatible = "renesas,shmobile-flctl-sh7372";
reg = <0xe6a30000 0x100>;
interrupts = <0x0d80>;
nand-bus-width = <16>;
dmas = <&dmac 1 /* data_tx */
&dmac 2;> /* data_rx */
dma-names = "data_tx", "data_rx";
system@0 {
label = "system";
reg = <0x0 0x8000000>;
};
userdata@8000000 {
label = "userdata";
reg = <0x8000000 0x10000000>;
};
cache@18000000 {
label = "cache";
reg = <0x18000000 0x8000000>;
};
};
요약과 해설
flctl-nand.txt:1-49Data·ECC DMA channel과 system·userdata·cache partition을 설명합니다.