← Documents Documentation/devicetree/bindings/hsi/nokia-modem.txt GitHub 원문 ↗

Linux 6.18.37 · Devicetree Bindings

Nokia Modem HSI Client

N900/N950/N9 modem의 HSI channel, GPIO와 reset IRQ 바인딩입니다.

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

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

1. 요약·해설

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

요약과 해설

nokia-modem.txt:1-59

Modem control/data channel과 platform GPIO 차이를 설명합니다.

2. 영어 원문 전체

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

원문 전체 펼치기
1 Nokia modem client bindings
2
3 The Nokia modem HSI client follows the common HSI client binding
4 and inherits all required properties. The following additional
5 properties are needed by the Nokia modem HSI client:
6
7 Required properties:
8 - compatible: Should be one of
9 "nokia,n900-modem"
10 "nokia,n950-modem"
11 "nokia,n9-modem"
12 - hsi-channel-names: Should contain the following strings
13 "mcsaab-control"
14 "speech-control"
15 "speech-data"
16 "mcsaab-data"
17 - gpios: Should provide a GPIO handler for each GPIO listed in
18 gpio-names
19 - gpio-names: Should contain the following strings
20 "cmt_apeslpx" (for n900, n950, n9)
21 "cmt_rst_rq" (for n900, n950, n9)
22 "cmt_en" (for n900, n950, n9)
23 "cmt_rst" (for n900)
24 "cmt_bsi" (for n900)
25 - interrupts: Should be IRQ handle for modem's reset indication
26
27 Example:
28
29 &ssi_port {
30 modem: hsi-client {
31 compatible = "nokia,n900-modem";
32
33 pinctrl-names = "default";
34 pinctrl-0 = <&modem_pins>;
35
36 hsi-channel-ids = <0>, <1>, <2>, <3>;
37 hsi-channel-names = "mcsaab-control",
38 "speech-control",
39 "speech-data",
40 "mcsaab-data";
41 hsi-speed-kbps = <55000>;
42 hsi-mode = "frame";
43 hsi-flow = "synchronized";
44 hsi-arb-mode = "round-robin";
45
46 interrupts-extended = <&gpio3 8 IRQ_TYPE_EDGE_FALLING>; /* 72 */
47
48 gpios = <&gpio3 6 GPIO_ACTIVE_HIGH>, /* 70 */
49 <&gpio3 9 GPIO_ACTIVE_HIGH>, /* 73 */
50 <&gpio3 10 GPIO_ACTIVE_HIGH>, /* 74 */
51 <&gpio3 11 GPIO_ACTIVE_HIGH>, /* 75 */
52 <&gpio5 29 GPIO_ACTIVE_HIGH>; /* 157 */
53 gpio-names = "cmt_apeslpx",
54 "cmt_rst_rq",
55 "cmt_en",
56 "cmt_rst",
57 "cmt_bsi";
58 };
59 };
60

3. 한국어 전문 번역

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

Nokia modem HSI client 속성

1-26

Nokia modem HSI client는 공통 HSI client binding을 따르고 모든 필수 속성을 상속합니다. 추가 `compatible`은 `nokia,n900-modem`, `nokia,n950-modem`, `nokia,n9-modem` 중 하나입니다.

`hsi-channel-names`에는 `mcsaab-control`, `speech-control`, `speech-data`, `mcsaab-data`를 포함해야 합니다. `gpios`는 `gpio-names`의 각 GPIO에 대한 handler를 제공해야 합니다.

`gpio-names`에서 `cmt_apeslpx`, `cmt_rst_rq`, `cmt_en`은 N900, N950, N9 모두에 사용합니다. `cmt_rst`와 `cmt_bsi`는 N900에만 사용합니다. `interrupts`는 modem reset indication의 IRQ handle입니다.

Nokia modem HSI 연결
HSI channels 0..3Control, speech, data transport
Control GPIOsSleep, reset request, enable, reset, BSI
Reset indication IRQFalling-edge modem event
Nokia modemN900/N950/N9 compatible

HSI channel, modem control GPIO와 reset indication IRQ의 역할을 구분합니다.

Nokia N900 modem 예제

27-59

예제 N900 modem은 default pinctrl, 공통 HSI channel 4개, 55,000 kbit/s frame mode와 synchronized round-robin 설정을 사용합니다. GPIO3 line 8의 falling-edge interrupt를 reset indication으로 받고 GPIO3/5의 다섯 active-high line을 modem control 이름과 같은 순서로 연결합니다.

&ssi_port {
        modem: hsi-client {
                compatible = "nokia,n900-modem";

                pinctrl-names = "default";
                pinctrl-0 = <&modem_pins>;

                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";

                interrupts-extended = <&gpio3 8 IRQ_TYPE_EDGE_FALLING>; /* 72 */

                gpios = <&gpio3  6 GPIO_ACTIVE_HIGH>, /* 70 */
                        <&gpio3  9 GPIO_ACTIVE_HIGH>, /* 73 */
                        <&gpio3 10 GPIO_ACTIVE_HIGH>, /* 74 */
                        <&gpio3 11 GPIO_ACTIVE_HIGH>, /* 75 */
                        <&gpio5 29 GPIO_ACTIVE_HIGH>; /* 157 */
                gpio-names = "cmt_apeslpx",
                             "cmt_rst_rq",
                             "cmt_en",
                             "cmt_rst",
                             "cmt_bsi";
        };
};