Cirrus CS53L30 audio codec | Linux 6.18.37

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

1. 요약·해설

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

요약과 해설

cs53l30.txt:1-44

Audio codec의 bus·전원·clock·microphone·jack detection 속성을 먼저 해설하고, 접을 수 있는 영어 원문 전체와 원문 줄 좌표를 보존한 한국어 전문 번역을 제공합니다.

2. 영어 원문 전체

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

원문 전체 펼치기

1 CS53L30 audio CODEC

3 Required properties:

5 - compatible : "cirrus,cs53l30"

7 - reg : the I2C address of the device

9 - VA-supply, VP-supply : power supplies for the device,

10 as covered in Documentation/devicetree/bindings/regulator/regulator.txt.

12 Optional properties:

14 - reset-gpios : a GPIO spec for the reset pin.

16 - mute-gpios : a GPIO spec for the MUTE pin. The active state can be either

17 GPIO_ACTIVE_HIGH or GPIO_ACTIVE_LOW, which would be handled

18 by the driver automatically.

20 - cirrus,micbias-lvl : Set the output voltage level on the MICBIAS Pin.

21 0 = Hi-Z

22 1 = 1.80 V

23 2 = 2.75 V

25 - cirrus,use-sdout2 : This is a boolean property. If present, it indicates

26 the hardware design connects both SDOUT1 and SDOUT2

27 pins to output data. Otherwise, it indicates that

28 only SDOUT1 is connected for data output.

29 * CS53l30 supports 4-channel data output in the same

30 * frame using two different ways:

31 * 1) Normal I2S mode on two data pins -- each SDOUT

32 * carries 2-channel data in the same time.

33 * 2) TDM mode on one single data pin -- SDOUT1 carries

34 * 4-channel data per frame.

36 Example:

38 codec: cs53l30@48 {

39 compatible = "cirrus,cs53l30";

40 reg = <0x48>;

41 reset-gpios = <&gpio 54 0>;

42 VA-supply = <&cs53l30_va>;

43 VP-supply = <&cs53l30_vp>;

44 };

3. 한국어 전문 번역

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

CS53L30 필수 속성

1-11

CS53L30 audio CODEC의 `compatible` 값은 `cirrus,cs53l30`이고 `reg`에는 I2C 장치 주소를 지정합니다.

`VA-supply`와 `VP-supply`는 `Documentation/devicetree/bindings/regulator/regulator.txt`에 정의된 장치 전원을 가리킵니다.

Reset, mute와 MICBIAS

12-24

`reset-gpios`는 reset pin의 GPIO spec입니다. `mute-gpios`는 MUTE pin의 GPIO spec이며 active state는 `GPIO_ACTIVE_HIGH` 또는 `GPIO_ACTIVE_LOW`일 수 있고 driver가 자동으로 처리합니다.

`cirrus,micbias-lvl`은 MICBIAS pin output voltage를 정합니다. 값 0은 Hi-Z, 1은 1.80V, 2는 2.75V입니다.

SDOUT 두 개와 4-channel 출력

25-35

Boolean `cirrus,use-sdout2`가 있으면 hardware가 SDOUT1과 SDOUT2를 모두 data output에 연결한 것입니다. 없으면 SDOUT1만 연결됩니다.

CS53L30은 두 방식으로 같은 frame에 4-channel data를 출력합니다. Normal I2S mode에서는 data pin 두 개가 각각 2-channel data를 동시에 운반하고, TDM mode에서는 SDOUT1 한 pin이 frame마다 4-channel data를 운반합니다.

CS53L30 예제

36-44

예제는 I2C 주소 `0x48`, reset GPIO와 VA·VP regulator를 지정합니다.

codec: cs53l30@48 {
        compatible = "cirrus,cs53l30";
        reg = <0x48>;
        reset-gpios = <&gpio 54 0>;
        VA-supply = <&cs53l30_va>;
        VP-supply = <&cs53l30_vp>;
};