Realtek RT5663 codec | Linux 6.18.37

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

1. 요약·해설

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

요약과 해설

rt5663.txt:1-60

RT5663 전원, DC offset과 impedance sensing matrix를 설명합니다. 영어 원문 전체와 줄 좌표를 보존하고 한국어 전문 번역에서는 property·pin·phandle·수치와 예제 코드를 원형대로 유지합니다.

2. 영어 원문 전체

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

원문 전체 펼치기

1 RT5663 audio CODEC

3 This device supports I2C only.

5 Required properties:

7 - compatible : "realtek,rt5663".

9 - reg : The I2C address of the device.

11 - interrupts : The CODEC's interrupt output.

13 - avdd-supply: Power supply for AVDD, providing 1.8V.

15 - cpvdd-supply: Power supply for CPVDD, providing 3.5V.

17 Optional properties:

19 - "realtek,dc_offset_l_manual"

20 - "realtek,dc_offset_r_manual"

21 - "realtek,dc_offset_l_manual_mic"

22 - "realtek,dc_offset_r_manual_mic"

23 Based on the different PCB layout, add the manual offset value to

24 compensate the DC offset for each L and R channel, and they are different

25 between headphone and headset.

26 - "realtek,impedance_sensing_num"

27 The matrix row number of the impedance sensing table.

28 If the value is 0, it means the impedance sensing is not supported.

29 - "realtek,impedance_sensing_table"

30 The matrix rows of the impedance sensing table are consisted by impedance

31 minimum, impedance maximum, volume, DC offset w/o and w/ mic of each L and

32 R channel accordingly. Example is shown as following.

33 < 0 300 7 0xffd160 0xffd1c0 0xff8a10 0xff8ab0

34 301 65535 4 0xffe470 0xffe470 0xffb8e0 0xffb8e0>

35 The first and second column are defined for the impedance range. If the

36 detected impedance value is in the range, then the volume value of the

37 third column will be set to codec. In our codec design, each volume value

38 should compensate different DC offset to avoid the pop sound, and it is

39 also different between headphone and headset. In the example, the

40 "realtek,impedance_sensing_num" is 2. It means that there are 2 ranges of

41 impedance in the impedance sensing function.

43 Pins on the device (for linking into audio routes) for RT5663:

45 * IN1P

46 * IN1N

47 * IN2P

48 * IN2N

49 * HPOL

50 * HPOR

52 Example:

54 rt5663: codec@12 {

55 compatible = "realtek,rt5663";

56 reg = <0x12>;

57 interrupts = <7 IRQ_TYPE_EDGE_FALLING>;

58 avdd-supply = <&pp1800_a_alc5662>;

59 cpvdd-supply = <&pp3500_a_alc5662>;

60 };

3. 한국어 전문 번역

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

RT5663 interrupt·전원 속성

1-16

RT5663는 I2C codec이며 필수 `compatible`은 `realtek,rt5663`, `reg`는 I2C address, `interrupts`는 codec interrupt output입니다. `avdd-supply`는 1.8 V AVDD, `cpvdd-supply`는 3.5 V CPVDD power supply입니다.

DC offset·impedance sensing matrix

17-42

`realtek,dc_offset_l_manual`, `realtek,dc_offset_r_manual`, `realtek,dc_offset_l_manual_mic`, `realtek,dc_offset_r_manual_mic`은 PCB layout과 headphone·headset 차이에 따라 L/R channel DC offset을 보정합니다.

`realtek,impedance_sensing_num`은 impedance table row 수이며 0이면 sensing을 지원하지 않습니다. `realtek,impedance_sensing_table`의 각 row는 minimum·maximum impedance, volume, microphone이 없을 때와 있을 때의 L/R DC offset으로 구성됩니다. 감지값이 첫 두 column 범위에 들면 세 번째 column volume과 해당 offset을 적용해 pop sound를 줄입니다.

RT5663 impedance sensing example

Min ZMax ZVolumeL offset no micL offset micR offset no micR offset mic

030070xffd1600xffd1c00xff8a100xff8ab0

3016553540xffe4700xffe4700xffb8e00xffb8e0

원문의 두 matrix row를 각 의미 column으로 구조화했습니다.

RT5663 route pin

43-51

Route pin은 `IN1P`, `IN1N`, `IN2P`, `IN2N`, `HPOL`, `HPOR`입니다.

RT5663 예제

52-60

예제는 address `0x12`, falling-edge interrupt 7, 1.8 V AVDD와 3.5 V CPVDD supply를 지정합니다.

rt5663: codec@12 {
        compatible = "realtek,rt5663";
        reg = <0x12>;
        interrupts = <7 IRQ_TYPE_EDGE_FALLING>;
        avdd-supply = <&pp1800_a_alc5662>;
        cpvdd-supply = <&pp3500_a_alc5662>;
};