← Documents Documentation/devicetree/bindings/hsi/client-devices.txt GitHub 원문 ↗

Linux 6.18.37 · Devicetree Bindings

HSI Client Devices

HSI channel, transmission mode, flow와 arbitration의 공통 client 바인딩입니다.

Source pathDocumentation/devicetree/bindings/hsi/client-devices.txt
Source versionLinux v6.18.37
TranslationDUJINLABS 전문 번역 + 해설

요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.

1. 요약·해설

원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.

요약과 해설

client-devices.txt:1-44

HSI port child와 N900 modem transport 예제를 설명합니다.

2. 영어 원문 전체

번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.

원문 전체 펼치기
1 Each HSI port is supposed to have one child node, which
2 symbols the remote device connected to the HSI port. The
3 following properties are standardized for HSI clients:
4
5 Required HSI configuration properties:
6
7 - hsi-channel-ids: A list of channel ids
8
9 - hsi-rx-mode: Receiver Bit transmission mode ("stream" or "frame")
10 - hsi-tx-mode: Transmitter Bit transmission mode ("stream" or "frame")
11 - hsi-mode: May be used instead hsi-rx-mode and hsi-tx-mode if
12 the transmission mode is the same for receiver and
13 transmitter
14 - hsi-speed-kbps: Max bit transmission speed in kbit/s
15 - hsi-flow: RX flow type ("synchronized" or "pipeline")
16 - hsi-arb-mode: Arbitration mode for TX frame ("round-robin", "priority")
17
18 Optional HSI configuration properties:
19
20 - hsi-channel-names: A list with one name per channel specified in the
21 hsi-channel-ids property
22
23
24 Device Tree node example for an HSI client:
25
26 hsi-controller {
27 hsi-port {
28 modem: hsi-client {
29 compatible = "nokia,n900-modem";
30
31 hsi-channel-ids = <0>, <1>, <2>, <3>;
32 hsi-channel-names = "mcsaab-control",
33 "speech-control",
34 "speech-data",
35 "mcsaab-data";
36 hsi-speed-kbps = <55000>;
37 hsi-mode = "frame";
38 hsi-flow = "synchronized";
39 hsi-arb-mode = "round-robin";
40
41 /* more client specific properties */
42 };
43 };
44 };
45

3. 한국어 전문 번역

영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.

공통 HSI client 속성

1-23

각 HSI port에는 그 port에 연결된 remote device를 나타내는 child node 하나가 있어야 합니다. HSI client의 표준 필수 configuration property는 다음과 같습니다.

`hsi-channel-ids`는 channel ID 목록입니다. `hsi-rx-mode`와 `hsi-tx-mode`는 각각 receiver와 transmitter bit transmission mode이며 `stream` 또는 `frame`입니다. RX와 TX mode가 같으면 두 속성 대신 `hsi-mode`를 사용할 수 있습니다.

`hsi-speed-kbps`는 kbit/s 단위 최대 bit transmission speed입니다. `hsi-flow`는 RX flow type으로 `synchronized` 또는 `pipeline`, `hsi-arb-mode`는 TX frame arbitration mode로 `round-robin` 또는 `priority`입니다.

선택 `hsi-channel-names`는 `hsi-channel-ids`에 지정한 channel마다 이름 하나를 같은 순서로 제공하는 목록입니다.

HSI client transport 설정
Property허용 값/단위역할
hsi-rx-mode / hsi-tx-modestream, frame방향별 transmission mode
hsi-modestream, frameRX/TX 공통 mode
hsi-speed-kbpskbit/s최대 전송 속도
hsi-flowsynchronized, pipelineRX flow
hsi-arb-moderound-robin, priorityTX arbitration

RX/TX mode, flow와 arbitration 선택지를 정리합니다.

N900 modem HSI client 예제

24-44

예제 modem client는 channel 0~3을 control/data 용도로 이름 붙이고 55,000 kbit/s, frame mode, synchronized flow, round-robin arbitration을 사용합니다. 추가 client별 property는 별도로 둘 수 있습니다.

hsi-controller {
        hsi-port {
                modem: hsi-client {
                        compatible = "nokia,n900-modem";

                        hsi-channel-ids = <0>, <1>, <2>, <3>;
                        hsi-channel-names = "mcsaab-control",
                                            "speech-control",
                                            "speech-data",
                                            "mcsaab-data";
                        hsi-speed-kbps = <55000>;
                        hsi-mode = "frame";
                        hsi-flow = "synchronized";
                        hsi-arb-mode = "round-robin";

                        /* more client specific properties */
                };
        };
};