요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
CS35L34 Speaker Amplifier
Required properties:
- compatible : "cirrus,cs35l34"
- reg : the I2C address of the device for I2C.
- VA-supply, VP-supply : power supplies for the device,
as covered in
Documentation/devicetree/bindings/regulator/regulator.txt.
- cirrus,boost-vtge-millivolt : Boost Voltage Value. Configures the boost
converter's output voltage in mV. The range is from VP to 8V with
increments of 100mV.
- cirrus,boost-nanohenry: Inductor value for boost converter. The value is
in nH and they can be values of 1000nH, 1100nH, 1200nH, 1500nH, and 2200nH.
Optional properties:
- reset-gpios: GPIO used to reset the amplifier.
- interrupts : IRQ line info CS35L34.
(See Documentation/devicetree/bindings/interrupt-controller/interrupts.txt
for further information relating to interrupt properties)
- cirrus,boost-peak-milliamp : Boost converter peak current limit in mA. The
range starts at 1200mA and goes to a maximum of 3840mA with increments of
80mA. The default value is 2480mA.
- cirrus,i2s-sdinloc : ADSP SDIN I2S channel location. Indicates whether the
received mono data is in the left or right portion of the I2S frame
according to the AD0 pin or directly via this configuration.
0x0 (Default) = Selected by AD0 input (if AD0 = LOW, use left channel),
0x2 = Left,
0x1 = Selected by the inversion of the AD0 input (if AD0 = LOW, use right
channel),
0x3 = Right.
- cirrus,gain-zc-disable: Boolean property. If set, the gain change will take
effect without waiting for a zero cross.
- cirrus,tdm-rising-edge: Boolean property. If set, data is on the rising edge of
SCLK. Otherwise, data is on the falling edge of SCLK.
Example:
cs35l34: cs35l34@40 {
compatible = "cirrus,cs35l34";
reg = <0x40>;
interrupt-parent = <&gpio8>;
interrupts = <3 IRQ_TYPE_LEVEL_LOW>;
reset-gpios = <&gpio 10 0>;
cirrus,boost-vtge-milltvolt = <8000>; /* 8V */
cirrus,boost-ind-nanohenry = <1000>; /* 1uH */
cirrus,boost-peak-milliamp = <3000>; /* 3A */
};
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
CS35L34 필수 속성
1-19CS35L34 스피커 증폭기의 `compatible` 값은 `cirrus,cs35l34`이고 `reg`에는 I2C 장치 주소를 지정합니다. `VA-supply`와 `VP-supply`는 `Documentation/devicetree/bindings/regulator/regulator.txt`에 정의된 전원 공급 장치를 가리킵니다.
`cirrus,boost-vtge-millivolt`는 boost converter output voltage를 mV 단위로 설정합니다. 범위는 VP부터 8V까지이며 100mV 단위로 증가합니다.
`cirrus,boost-nanohenry`는 boost converter inductor 값을 nH 단위로 지정합니다. 허용값은 1000nH, 1100nH, 1200nH, 1500nH, 2200nH입니다.
Reset, IRQ와 peak current
20-31선택 속성 `reset-gpios`는 증폭기를 reset하는 GPIO이고 `interrupts`는 CS35L34의 IRQ 선 정보입니다. Interrupt 속성의 자세한 규칙은 `Documentation/devicetree/bindings/interrupt-controller/interrupts.txt`를 참조합니다.
`cirrus,boost-peak-milliamp`는 boost converter peak current limit를 mA 단위로 정합니다. 범위는 1200mA부터 최대 3840mA까지이고 80mA 단위로 증가하며 기본값은 2480mA입니다.
I2S channel과 timing
32-47`cirrus,i2s-sdinloc`은 수신한 mono data가 I2S frame의 왼쪽과 오른쪽 중 어디에 놓이는지 정합니다. 값 `0x0`은 AD0 input을 그대로 따라 AD0가 LOW이면 left channel, `0x2`는 left, `0x1`은 AD0 input을 반전해 AD0가 LOW이면 right channel, `0x3`은 right를 선택합니다.
Boolean 속성 `cirrus,gain-zc-disable`을 설정하면 gain 변경이 zero cross를 기다리지 않고 적용됩니다. `cirrus,tdm-rising-edge`를 설정하면 data는 SCLK rising edge에 놓이고, 설정하지 않으면 falling edge에 놓입니다.
CS35L34 예제
48-62예제는 주소 `0x40`, level-low interrupt와 reset GPIO를 지정하고 boost voltage 8V, inductor 1uH, peak current 3A를 구성합니다.
예제의 `cirrus,boost-vtge-milltvolt`와 `cirrus,boost-ind-nanohenry` 표기는 위 필수 속성 이름과 다릅니다. 원문 예제 코드는 수정하지 않고 그대로 보존했습니다.
cs35l34: cs35l34@40 {
compatible = "cirrus,cs35l34";
reg = <0x40>;
interrupt-parent = <&gpio8>;
interrupts = <3 IRQ_TYPE_LEVEL_LOW>;
reset-gpios = <&gpio 10 0>;
cirrus,boost-vtge-milltvolt = <8000>; /* 8V */
cirrus,boost-ind-nanohenry = <1000>; /* 1uH */
cirrus,boost-peak-milliamp = <3000>; /* 3A */
};
요약과 해설
cs35l34.txt:1-62스피커 증폭기의 전원, boost, audio timing과 보호 제어 속성을 먼저 해설하고, 접을 수 있는 영어 원문 전체와 원문 줄 좌표를 보존한 한국어 전문 번역을 제공합니다.