요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
* Renesas usdhi6rol0 SD/SDIO host controller
Required properties:
- compatible: must be
"renesas,usdhi6rol0"
- interrupts: 3 interrupts, named "card detect", "data" and "SDIO" must be
specified
- clocks: a clock binding for the IMCLK input
Optional properties:
- vmmc-supply: a phandle of a regulator, supplying Vcc to the card
- vqmmc-supply: a phandle of a regulator, supplying VccQ to the card
- pinctrl-names: Can contain a "default" entry and a "state_uhs"
entry. The state_uhs entry is used together with the default
entry when the board requires distinct settings for UHS speeds.
- pinctrl-N: One property for each name listed in pinctrl-names, see
../pinctrl/pinctrl-bindings.txt.
Additionally any standard mmc bindings from mmc.txt can be used.
Example:
sd0: sd@ab000000 {
compatible = "renesas,usdhi6rol0";
reg = <0xab000000 0x200>;
interrupts = <0 23 0x4
0 24 0x4
0 25 0x4>;
interrupt-names = "card detect", "data", "SDIO";
bus-width = <4>;
max-frequency = <50000000>;
cap-power-off-card;
clocks = <&imclk>;
vmmc-supply = <&vcc_sd0>;
vqmmc-supply = <&vccq_sd0>;
};
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
Renesas usdhi6rol0 host
1-2이 문서는 Renesas `usdhi6rol0` SD·SDIO host controller 바인딩입니다.
세 interrupt와 IMCLK
3-10필수 `compatible`은 `renesas,usdhi6rol0`입니다. `interrupts`에는 이름이 각각 `card detect`, `data`, `SDIO`인 interrupt 세 개를 지정해야 하며, `clocks`에는 IMCLK input의 clock binding을 넣습니다.
세 interrupt는 card 상태와 전송, SDIO event를 분리합니다.
Card 전원과 UHS pinctrl
11-23선택 `vmmc-supply`는 card Vcc를 공급하는 regulator의 phandle이고, `vqmmc-supply`는 card VccQ를 공급하는 regulator의 phandle입니다.
`pinctrl-names`에는 `default`와 `state_uhs`를 넣을 수 있습니다. Board가 UHS 속도에서 별도 pin 설정을 필요로 할 때 `state_uhs`를 `default`와 함께 사용합니다. 각 이름에는 `../pinctrl/pinctrl-bindings.txt` 형식의 `pinctrl-N` 속성이 하나씩 대응합니다.
이 속성들 외에도 `mmc.txt`의 모든 표준 MMC 바인딩을 사용할 수 있습니다.
Renesas SD0 예제
24-39예제는 `0xab000000`의 controller에 세 interrupt와 이름을 순서대로 연결하고, 4-bit bus, 50MHz, card power-off capability, IMCLK, VMMC와 VQMMC regulator를 설정합니다.
sd0: sd@ab000000 {
compatible = "renesas,usdhi6rol0";
reg = <0xab000000 0x200>;
interrupts = <0 23 0x4
0 24 0x4
0 25 0x4>;
interrupt-names = "card detect", "data", "SDIO";
bus-width = <4>;
max-frequency = <50000000>;
cap-power-off-card;
clocks = <&imclk>;
vmmc-supply = <&vcc_sd0>;
vqmmc-supply = <&vccq_sd0>;
};
요약과 해설
usdhi6rol0.txt:1-39Card detect·data·SDIO interrupt와 UHS pinctrl을 설명합니다.