RK3288 HDMI analog audio | Linux 6.18.37

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

1. 요약·해설

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

요약과 해설

rockchip,rk3288-hdmi-analog.txt:1-36

RK3288 analog routing과 headphone enable·detection GPIO를 설명합니다. 영어 원문 전체와 줄 좌표를 보존하고, 한국어 전문 번역에서는 module·property·command·source path를 원형으로 유지하며 ASCII 구조도와 표를 구조화해 제공합니다.

2. 영어 원문 전체

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

원문 전체 펼치기

1 ROCKCHIP RK3288 with HDMI and analog audio

3 Required properties:

4 - compatible: "rockchip,rk3288-hdmi-analog"

5 - rockchip,model: The user-visible name of this sound complex

6 - rockchip,i2s-controller: The phandle of the Rockchip I2S controller that's

7 connected to the CODEC

8 - rockchip,audio-codec: The phandle of the analog audio codec.

9 - rockchip,routing: A list of the connections between audio components.

10 Each entry is a pair of strings, the first being the

11 connection's sink, the second being the connection's

12 source. For this driver the first string should always be

13 "Analog".

15 Optional properties:

16 - rockchip,hp-en-gpios = The phandle of the GPIO that power up/down the

17 headphone (when the analog output is an headphone).

18 - rockchip,hp-det-gpios = The phandle of the GPIO that detects the headphone

19 (when the analog output is an headphone).

20 - pinctrl-names, pinctrl-0: Please refer to pinctrl-bindings.txt

22 Example:

24 sound {

25 compatible = "rockchip,rk3288-hdmi-analog";

26 rockchip,model = "Analog audio output";

27 rockchip,i2s-controller = <&i2s>;

28 rockchip,audio-codec = <&es8388>;

29 rockchip,routing = "Analog", "LOUT2",

30 "Analog", "ROUT2";

31 rockchip,hp-en-gpios = <&gpio8 0 GPIO_ACTIVE_HIGH>;

32 rockchip,hp-det-gpios = <&gpio7 7 GPIO_ACTIVE_HIGH>;

33 pinctrl-names = "default";

34 pinctrl-0 = <&headphone>;

35 };

3. 한국어 전문 번역

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

RK3288 HDMI·analog 속성

1-21

필수 `compatible`은 `rockchip,rk3288-hdmi-analog`, `rockchip,model`은 card 이름, `rockchip,i2s-controller`는 I2S controller phandle, `rockchip,audio-codec`은 analog codec phandle입니다.

`rockchip,routing`은 sink·source 문자열 pair 목록이며 이 driver에서는 각 pair의 첫 문자열이 항상 `Analog`여야 합니다. 선택 `rockchip,hp-en-gpios`는 headphone power, `rockchip,hp-det-gpios`는 headphone detection GPIO입니다. `pinctrl-names`와 `pinctrl-0`은 `pinctrl-bindings.txt`를 따릅니다.

ES8388 headphone 예제

22-36

예제는 ES8388의 `LOUT2`·`ROUT2`를 `Analog` output으로 route하고 active-high headphone enable·detect GPIO와 기본 pinctrl을 지정합니다.

sound {
        compatible = "rockchip,rk3288-hdmi-analog";
        rockchip,model = "Analog audio output";
        rockchip,i2s-controller = <&i2s>;
        rockchip,audio-codec = <&es8388>;
        rockchip,routing = "Analog", "LOUT2",
                           "Analog", "ROUT2";
        rockchip,hp-en-gpios = <&gpio8 0 GPIO_ACTIVE_HIGH>;
        rockchip,hp-det-gpios = <&gpio7 7 GPIO_ACTIVE_HIGH>;
        pinctrl-names = "default";
        pinctrl-0 = <&headphone>;
};