← Documents Documentation/devicetree/bindings/sound/foursemi,fs2105s.yaml GitHub 원문 ↗

Linux 6.18.37 · Devicetree Bindings / Sound

FourSemi FS2104/FS2105S amplifier

FS2104/5S amplifier의 BCLK, 전원, reset과 tuning firmware를 설명합니다.

Source pathDocumentation/devicetree/bindings/sound/foursemi,fs2105s.yaml
Source versionLinux v6.18.37
TranslationDUJINLABS 전문 번역 + 해설

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

1. 요약·해설

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

요약과 해설

foursemi,fs2105s.yaml:1-101

FourSemi amplifier와 Freescale/NXP audio card·controller의 compatible, clock, DMA, routing과 firmware 조건을 먼저 해설하고, 접을 수 있는 영어 원문 전체와 원문 줄 좌표를 보존한 한국어 전문 번역을 제공합니다.

2. 영어 원문 전체

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

원문 전체 펼치기
1 # SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2 %YAML 1.2
3 ---
4 $id: http://devicetree.org/schemas/sound/foursemi,fs2105s.yaml#
5 $schema: http://devicetree.org/meta-schemas/core.yaml#
6
7 title: FourSemi FS2104/5S Digital Audio Amplifier
8
9 maintainers:
10 - Nick Li <[email protected]>
11
12 description:
13 The FS2104 is a 15W Inductor-Less, Stereo, Closed-Loop,
14 Digital Input Class-D Power Amplifier with Enhanced Signal Processing.
15 The FS2105S is a 30W Inductor-Less, Stereo, Closed-Loop,
16 Digital Input Class-D Power Amplifier with Enhanced Signal Processing.
17
18 properties:
19 compatible:
20 oneOf:
21 - items:
22 - enum:
23 - foursemi,fs2104
24 - const: foursemi,fs2105s
25 - enum:
26 - foursemi,fs2105s
27
28 reg:
29 maxItems: 1
30
31 clocks:
32 items:
33 - description: The clock of I2S BCLK
34
35 clock-names:
36 items:
37 - const: bclk
38
39 interrupts:
40 maxItems: 1
41
42 '#sound-dai-cells':
43 const: 0
44
45 pvdd-supply:
46 description:
47 Regulator for power supply(PVDD in datasheet).
48
49 dvdd-supply:
50 description:
51 Regulator for digital supply(DVDD in datasheet).
52
53 reset-gpios:
54 maxItems: 1
55 description:
56 It's the SDZ pin in datasheet, the pin is active low,
57 it will power down and reset the chip to shut down state.
58
59 firmware-name:
60 maxItems: 1
61 description: |
62 The firmware(*.bin) contains:
63 a. Register initialization settings
64 b. DSP effect parameters
65 c. Multi-scene sound effect configurations(optional)
66 It's gernerated by FourSemi's tuning tool.
67
68 required:
69 - compatible
70 - reg
71 - '#sound-dai-cells'
72 - pvdd-supply
73 - dvdd-supply
74 - reset-gpios
75 - firmware-name
76
77 allOf:
78 - $ref: dai-common.yaml#
79
80 unevaluatedProperties: false
81
82 examples:
83 - |
84 #include <dt-bindings/gpio/gpio.h>
85 i2c {
86 #address-cells = <1>;
87 #size-cells = <0>;
88 audio-codec@68 {
89 compatible = "foursemi,fs2105s";
90 reg = <0x68>;
91 clocks = <&clocks 18>;
92 clock-names = "bclk";
93 #sound-dai-cells = <0>;
94 pvdd-supply = <&pvdd_supply>;
95 dvdd-supply = <&dvdd_supply>;
96 reset-gpios = <&gpio 18 GPIO_ACTIVE_LOW>;
97 firmware-name = "fs2105s-btl-2p0-0s.bin";
98 pinctrl-names = "default";
99 pinctrl-0 = <&fs210x_pins_default>;
100 };
101 };
102

3. 한국어 전문 번역

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

FS2104/FS2105S amplifier

1-17

이 YAML binding은 FourSemi FS2104/FS2105S digital audio amplifier를 정의합니다. Schema ID는 `http://devicetree.org/schemas/sound/foursemi,fs2105s.yaml#`이고 maintainer는 Nick Li입니다.

FS2104는 enhanced signal processing을 갖춘 15W inductor-less stereo closed-loop digital-input Class-D power amplifier이고, FS2105S는 같은 구조의 30W 모델입니다.

Compatible, BCLK와 interrupt

18-44

`compatible`은 단일 `foursemi,fs2105s`이거나 `foursemi,fs2104` 뒤에 fallback `foursemi,fs2105s`을 둔 두 항목입니다. `reg`와 `interrupts`는 각각 최대 한 항목입니다.

`clocks`는 I2S BCLK 한 항목이고 `clock-names`는 `bclk`입니다. `#sound-dai-cells`는 0입니다.

전원, reset과 firmware

45-67

`pvdd-supply`는 datasheet의 PVDD power supply, `dvdd-supply`는 DVDD digital supply regulator를 참조합니다.

`reset-gpios`는 datasheet의 active-low SDZ pin 한 항목입니다. Assert하면 chip의 전원을 내리고 shutdown state로 reset합니다.

`firmware-name`은 FourSemi tuning tool이 생성한 `.bin` firmware 이름 한 항목입니다. Firmware에는 register initialization 설정, DSP effect parameter, 선택적인 multi-scene sound effect 구성이 들어갑니다.

필수 속성과 공통 DAI

68-81

필수 속성은 `compatible`, `reg`, `#sound-dai-cells`, `pvdd-supply`, `dvdd-supply`, `reset-gpios`, `firmware-name`입니다. `dai-common.yaml#`을 상속하며 평가되지 않은 추가 속성은 허용하지 않습니다.

FS2105S I2C 예제

82-101

예제는 I2C address `0x68`의 FS2105S에 BCLK, 두 전원, active-low reset GPIO, firmware `fs2105s-btl-2p0-0s.bin`과 pin control을 연결합니다.

#include <dt-bindings/gpio/gpio.h>
i2c {
    #address-cells = <1>;
    #size-cells = <0>;
    audio-codec@68 {
        compatible = "foursemi,fs2105s";
        reg = <0x68>;
        clocks = <&clocks 18>;
        clock-names = "bclk";
        #sound-dai-cells = <0>;
        pvdd-supply = <&pvdd_supply>;
        dvdd-supply = <&dvdd_supply>;
        reset-gpios = <&gpio 18 GPIO_ACTIVE_LOW>;
        firmware-name = "fs2105s-btl-2p0-0s.bin";
        pinctrl-names = "default";
        pinctrl-0 = <&fs210x_pins_default>;
    };
};