요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
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. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 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을 설명합니다.