요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
Device-Tree bindings for ST IRB IP
Required properties:
- compatible: Should contain "st,comms-irb".
- reg: Base physical address of the controller and length of memory
mapped region.
- interrupts: interrupt-specifier for the sole interrupt generated by
the device. The interrupt specifier format depends on the interrupt
controller parent.
- rx-mode: can be "infrared" or "uhf". This property specifies the L1
protocol used for receiving remote control signals. rx-mode should
be present iff the rx pins are wired up.
- tx-mode: should be "infrared". This property specifies the L1
protocol used for transmitting remote control signals. tx-mode should
be present iff the tx pins are wired up.
Optional properties:
- pinctrl-names, pinctrl-0: the pincontrol settings to configure muxing
properly for IRB pins.
- clocks : phandle with clock-specifier pair for IRB.
Example node:
rc: rc@fe518000 {
compatible = "st,comms-irb";
reg = <0xfe518000 0x234>;
interrupts = <0 203 0>;
rx-mode = "infrared";
};
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
ST IRB 장치 트리 바인딩
1-2이 문서는 ST의 IRB(Infrared Blaster/Receiver) IP를 장치 트리에서 기술하는 방법을 정의합니다.
선택한 L1 모드에 따라 원격 제어 신호를 수신하거나 적외선으로 송신합니다.
필수 속성
3-16`compatible`에는 `st,comms-irb`를 넣습니다. `reg`는 컨트롤러의 물리 기준 주소와 매핑할 메모리 영역 길이를 나타냅니다. `interrupts`는 장치가 생성하는 유일한 인터럽트의 지정자이며, 그 형식은 상위 인터럽트 컨트롤러에 따라 달라집니다.
`rx-mode`는 `infrared` 또는 `uhf`일 수 있으며 원격 제어 신호를 받을 때 사용하는 L1 프로토콜을 지정합니다. RX 핀이 실제로 배선된 경우에만, 그리고 그 경우에는 반드시 이 속성이 있어야 합니다. `tx-mode`는 `infrared`여야 하며 송신 L1 프로토콜을 지정합니다. 마찬가지로 TX 핀이 배선된 경우에만, 그리고 그 경우에는 반드시 존재해야 합니다.
선택 속성
17-21`pinctrl-names`와 `pinctrl-0`는 IRB 핀의 멀티플렉싱을 올바르게 설정하는 핀 제어 상태입니다. `clocks`는 IRB에 공급되는 클록의 phandle과 clock specifier 쌍입니다.
적외선 수신 예제
22-29예제는 `0xfe518000`의 IRB 컨트롤러에 메모리 영역과 인터럽트 203을 지정하고, 수신 모드를 적외선으로 설정합니다. TX 속성이 없으므로 송신 핀이 사용된다는 뜻은 아닙니다.
rc: rc@fe518000 {
compatible = "st,comms-irb";
reg = <0xfe518000 0x234>;
interrupts = <0 203 0>;
rx-mode = "infrared";
};
요약과 해설
st-rc.txt:1-29RX/TX 배선 여부에 따른 조건부 필수 모드 속성과 적외선 수신 예제를 설명합니다.