요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
MIPI DSI (Display Serial Interface) busses
==========================================
The MIPI Display Serial Interface specifies a serial bus and a protocol for
communication between a host and up to four peripherals. This document will
define the syntax used to represent a DSI bus in a device tree.
This document describes DSI bus-specific properties only or defines existing
standard properties in the context of the DSI bus.
Each DSI host provides a DSI bus. The DSI host controller's node contains a
set of properties that characterize the bus. Child nodes describe individual
peripherals on that bus.
The following assumes that only a single peripheral is connected to a DSI
host. Experience shows that this is true for the large majority of setups.
DSI host
========
In addition to the standard properties and those defined by the parent bus of
a DSI host, the following properties apply to a node representing a DSI host.
Required properties:
- #address-cells: The number of cells required to represent an address on the
bus. DSI peripherals are addressed using a 2-bit virtual channel number, so
a maximum of 4 devices can be addressed on a single bus. Hence the value of
this property should be 1.
- #size-cells: Should be 0. There are cases where it makes sense to use a
different value here. See below.
Optional properties:
- clock-master: boolean. Should be enabled if the host is being used in
conjunction with another DSI host to drive the same peripheral. Hardware
supporting such a configuration generally requires the data on both the busses
to be driven by the same clock. Only the DSI host instance controlling this
clock should contain this property.
DSI peripheral
==============
Peripherals with DSI as control bus, or no control bus
------------------------------------------------------
Peripherals with the DSI bus as the primary control bus, or peripherals with
no control bus but use the DSI bus to transmit pixel data are represented
as child nodes of the DSI host's node. Properties described here apply to all
DSI peripherals, but individual bindings may want to define additional,
device-specific properties.
Required properties:
- reg: The virtual channel number of a DSI peripheral. Must be in the range
from 0 to 3.
Some DSI peripherals respond to more than a single virtual channel. In that
case two alternative representations can be chosen:
- The reg property can take multiple entries, one for each virtual channel
that the peripheral responds to.
- If the virtual channels that a peripheral responds to are consecutive, the
#size-cells can be set to 1. The first cell of each entry in the reg
property is the number of the first virtual channel and the second cell is
the number of consecutive virtual channels.
Peripherals with a different control bus
----------------------------------------
There are peripherals that have I2C/SPI (or some other non-DSI bus) as the
primary control bus, but are also connected to a DSI bus (mostly for the data
path). Connections between such peripherals and a DSI host can be represented
using the graph bindings [1], [2].
Peripherals that support dual channel DSI
-----------------------------------------
Peripherals with higher bandwidth requirements can be connected to 2 DSI
busses. Each DSI bus/channel drives some portion of the pixel data (generally
left/right half of each line of the display, or even/odd lines of the display).
The graph bindings should be used to represent the multiple DSI busses that are
connected to this peripheral. Each DSI host's output endpoint can be linked to
an input endpoint of the DSI peripheral.
[1] Documentation/devicetree/bindings/graph.txt
[2] Documentation/devicetree/bindings/media/video-interfaces.txt
Examples
========
- (1), (2) and (3) are examples of a DSI host and peripheral on the DSI bus
with different virtual channel configurations.
- (4) is an example of a peripheral on a I2C control bus connected to a
DSI host using of-graph bindings.
- (5) is an example of 2 DSI hosts driving a dual-channel DSI peripheral,
which uses I2C as its primary control bus.
1)
dsi-host {
...
#address-cells = <1>;
#size-cells = <0>;
/* peripheral responds to virtual channel 0 */
peripheral@0 {
compatible = "...";
reg = <0>;
};
...
};
2)
dsi-host {
...
#address-cells = <1>;
#size-cells = <0>;
/* peripheral responds to virtual channels 0 and 2 */
peripheral@0 {
compatible = "...";
reg = <0, 2>;
};
...
};
3)
dsi-host {
...
#address-cells = <1>;
#size-cells = <1>;
/* peripheral responds to virtual channels 1, 2 and 3 */
peripheral@1 {
compatible = "...";
reg = <1 3>;
};
...
};
4)
i2c-host {
...
dsi-bridge@35 {
compatible = "...";
reg = <0x35>;
ports {
...
port {
bridge_mipi_in: endpoint {
remote-endpoint = <&host_mipi_out>;
};
};
};
};
};
dsi-host {
...
ports {
...
port {
host_mipi_out: endpoint {
remote-endpoint = <&bridge_mipi_in>;
};
};
};
};
5)
i2c-host {
dsi-bridge@35 {
compatible = "...";
reg = <0x35>;
ports {
#address-cells = <1>;
#size-cells = <0>;
port@0 {
reg = <0>;
dsi0_in: endpoint {
remote-endpoint = <&dsi0_out>;
};
};
port@1 {
reg = <1>;
dsi1_in: endpoint {
remote-endpoint = <&dsi1_out>;
};
};
};
};
};
dsi0-host {
...
/*
* this DSI instance drives the clock for both the host
* controllers
*/
clock-master;
ports {
...
port {
dsi0_out: endpoint {
remote-endpoint = <&dsi0_in>;
};
};
};
};
dsi1-host {
...
ports {
...
port {
dsi1_out: endpoint {
remote-endpoint = <&dsi1_in>;
};
};
};
};
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
MIPI DSI bus와 host
1-38MIPI DSI(Display Serial Interface)는 host와 최대 네 peripheral 사이의 통신을 위한 serial bus와 protocol을 규정합니다. 이 문서는 Device Tree에서 DSI bus를 표현하는 문법을 정의하며, DSI 전용 속성 또는 기존 표준 속성이 DSI 문맥에서 갖는 의미만 설명합니다.
각 DSI host는 하나의 DSI bus를 제공합니다. Host controller node의 속성 집합이 bus의 특성을 나타내고, child node가 bus의 개별 peripheral을 나타냅니다. 여기서는 하나의 DSI host에 peripheral 하나만 연결한다고 가정하며, 실제 구성의 대다수가 이 형태입니다.
DSI host node에는 parent bus와 표준 속성에 더해 `#address-cells = <1>`이 필요합니다. DSI peripheral 주소는 2-bit virtual channel 번호이므로 한 bus에서 0부터 3까지 최대 네 device를 지정할 수 있습니다. `#size-cells`는 일반적으로 0이지만 아래에서 설명하는 연속 virtual channel 표현에는 다른 값을 사용할 수 있습니다.
선택 boolean `clock-master`는 두 DSI host가 같은 peripheral을 함께 구동할 때 clock을 제어하는 host에만 둡니다. 이런 hardware는 보통 두 bus의 data가 같은 clock으로 구동되어야 하므로 실제 공통 clock을 제어하는 DSI host instance 하나만 이 속성을 가져야 합니다.
Host node가 bus 속성을 소유하고 child node가 virtual channel로 주소 지정되는 peripheral을 나타냅니다.
DSI가 control bus인 peripheral
39-63DSI를 primary control bus로 사용하는 peripheral, 또는 별도 control bus 없이 DSI로 pixel data만 전송하는 peripheral은 DSI host node의 child node로 표현합니다. 여기의 공통 속성 외에 개별 binding이 device 전용 속성을 추가할 수 있습니다.
필수 `reg`는 DSI peripheral의 virtual channel 번호이며 0부터 3 사이여야 합니다. Peripheral이 여러 virtual channel에 응답하면 `reg`에 channel마다 entry를 하나씩 나열할 수 있습니다.
응답하는 virtual channel이 연속이면 `#size-cells = <1>`로 설정하는 대안도 있습니다. 이때 `reg` entry의 첫 cell은 첫 virtual channel 번호이고 두 번째 cell은 연속 channel 수입니다.
단일, 비연속 복수, 연속 복수 channel을 `reg`와 `#size-cells`로 표현합니다.
다른 control bus와 dual-channel DSI
64-84Primary control bus가 I2C, SPI 또는 다른 non-DSI bus이면서 data path를 위해 DSI에도 연결되는 peripheral은 graph binding으로 DSI host와의 연결을 표현할 수 있습니다.
더 높은 bandwidth가 필요한 peripheral은 두 DSI bus에 연결할 수 있습니다. 각 bus 또는 channel은 일반적으로 display 각 scanline의 왼쪽/오른쪽 절반이나 짝수/홀수 line처럼 pixel data의 일부를 구동합니다. 각 DSI host output endpoint를 peripheral의 서로 다른 input endpoint에 연결합니다.
Graph 형식은 `[1] Documentation/devicetree/bindings/graph.txt`와 `[2] Documentation/devicetree/bindings/media/video-interfaces.txt`를 참조합니다.
I2C가 제어하는 bridge의 두 DSI input을 두 host output에 각각 연결하고 한 host가 공통 clock을 제어합니다.
예제 1: 단일 virtual channel
85-109다섯 예제 중 (1), (2), (3)은 서로 다른 virtual channel 구성을, (4)는 I2C control bus peripheral과 DSI host의 of-graph 연결을, (5)는 I2C로 제어되는 dual-channel peripheral을 두 DSI host가 구동하는 구성을 보여 줍니다.
예제 (1)은 `#address-cells = <1>`, `#size-cells = <0>`인 host 아래에서 `peripheral@0`이 virtual channel 0 하나에 응답하는 기본 형태입니다.
dsi-host {
...
#address-cells = <1>;
#size-cells = <0>;
/* peripheral responds to virtual channel 0 */
peripheral@0 {
compatible = "...";
reg = <0>;
};
...
};예제 2: 비연속 virtual channel
110-125예제 (2)는 size cell 없이 `reg = <0, 2>`의 복수 entry를 사용하여 peripheral이 비연속 virtual channel 0과 2에 응답함을 나타냅니다.
dsi-host {
...
#address-cells = <1>;
#size-cells = <0>;
/* peripheral responds to virtual channels 0 and 2 */
peripheral@0 {
compatible = "...";
reg = <0, 2>;
};
...
};예제 3: 연속 virtual channel 범위
126-141예제 (3)은 `#size-cells = <1>`로 바꾸고 `reg = <1 3>`을 사용합니다. 첫 channel 1부터 연속 3개, 즉 virtual channel 1, 2, 3에 peripheral이 응답합니다.
dsi-host {
...
#address-cells = <1>;
#size-cells = <1>;
/* peripheral responds to virtual channels 1, 2 and 3 */
peripheral@1 {
compatible = "...";
reg = <1 3>;
};
...
};예제 4: I2C control bus와 DSI data path
142-175예제 (4)의 bridge는 I2C address `0x35`로 제어됩니다. Bridge의 `bridge_mipi_in` endpoint와 DSI host의 `host_mipi_out` endpoint가 서로를 `remote-endpoint`로 참조하여 DSI data path를 표현합니다. 원문의 생략 표기 `...`도 그대로 보존합니다.
i2c-host {
...
dsi-bridge@35 {
compatible = "...";
reg = <0x35>;
ports {
...
port {
bridge_mipi_in: endpoint {
remote-endpoint = <&host_mipi_out>;
};
};
};
};
};
dsi-host {
...
ports {
...
port {
host_mipi_out: endpoint {
remote-endpoint = <&bridge_mipi_in>;
};
};
};
};예제 5: 두 host가 구동하는 dual-channel bridge
176-235예제 (5)의 I2C bridge에는 input `port@0`과 `port@1`이 있으며 각각 `dsi0_in`과 `dsi1_in` endpoint를 갖습니다. 두 endpoint는 DSI host 0과 1의 output에 각각 연결됩니다.
`dsi0-host`만 `clock-master`를 선언하여 두 host controller의 clock을 구동합니다. `dsi1-host`는 별도 clock-master 선언 없이 두 번째 data channel만 제공합니다.
i2c-host {
dsi-bridge@35 {
compatible = "...";
reg = <0x35>;
ports {
#address-cells = <1>;
#size-cells = <0>;
port@0 {
reg = <0>;
dsi0_in: endpoint {
remote-endpoint = <&dsi0_out>;
};
};
port@1 {
reg = <1>;
dsi1_in: endpoint {
remote-endpoint = <&dsi1_out>;
};
};
};
};
};
dsi0-host {
...
/*
* this DSI instance drives the clock for both the host
* controllers
*/
clock-master;
ports {
...
port {
dsi0_out: endpoint {
remote-endpoint = <&dsi0_in>;
};
};
};
};
dsi1-host {
...
ports {
...
port {
dsi1_out: endpoint {
remote-endpoint = <&dsi1_in>;
};
};
};
};
요약과 해설
mipi-dsi-bus.txt:1-235DSI bus addressing, control bus 유형과 다섯 가지 구성 예제를 설명합니다.