요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
MOXA ART MMC Host Controller Interface
Inherits from mmc binding[1].
[1] Documentation/devicetree/bindings/mmc/mmc.txt
Required properties:
- compatible : Must be "moxa,moxart-mmc" or "faraday,ftsdc010"
- reg : Should contain registers location and length
- interrupts : Should contain the interrupt number
- clocks : Should contain phandle for the clock feeding the MMC controller
Optional properties:
- dmas : Should contain two DMA channels, line request number must be 5 for
both channels
- dma-names : Must be "tx", "rx"
Example:
mmc: mmc@98e00000 {
compatible = "moxa,moxart-mmc";
reg = <0x98e00000 0x5C>;
interrupts = <5 0>;
clocks = <&clk_apb>;
dmas = <&dma 5>,
<&dma 5>;
dma-names = "tx", "rx";
};
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
MOXA ART MMC host controller
1-6이 문서는 MOXA ART MMC Host Controller Interface를 정의합니다. 이 바인딩은 공통 MMC 바인딩을 상속하며, 원문 참조 `[1]`은 `Documentation/devicetree/bindings/mmc/mmc.txt`입니다.
필수 속성과 DMA 선택 속성
7-19필수 `compatible`은 `moxa,moxart-mmc` 또는 `faraday,ftsdc010`이어야 합니다. `reg`에는 register 위치와 길이, `interrupts`에는 interrupt 번호, `clocks`에는 MMC controller에 clock을 공급하는 clock의 phandle을 넣습니다.
선택 `dmas`에는 두 DMA channel을 넣으며 두 channel의 line request 번호는 모두 5여야 합니다. 대응하는 `dma-names`는 순서대로 `tx`, `rx`여야 합니다.
Controller 본체와 선택 DMA 연결을 구분합니다.
MOXART MMC와 DMA 예제
20-30예제는 `0x98e00000`의 controller에 interrupt 5와 APB clock을 연결하고, request 5를 쓰는 TX·RX DMA channel을 각각 지정합니다.
mmc: mmc@98e00000 {
compatible = "moxa,moxart-mmc";
reg = <0x98e00000 0x5C>;
interrupts = <5 0>;
clocks = <&clk_apb>;
dmas = <&dma 5>,
<&dma 5>;
dma-names = "tx", "rx";
};
요약과 해설
moxa,moxart-mmc.txt:1-30필수 controller 자원과 TX·RX DMA channel 구성을 설명합니다.