Broadcom BCM63xx Audio I2S | Linux 6.18.37

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

1. 요약·해설

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

요약과 해설

brcm,bcm63xx-audio.txt:1-29

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

2. 영어 원문 전체

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

원문 전체 펼치기

1 Broadcom DSL/PON BCM63xx Audio I2S controller

3 Required properties:

4 - compatible: Should be "brcm,bcm63xx-i2s".

5 - #address-cells: 32bit valued, 1 cell.

6 - #size-cells: 32bit valued, 0 cell.

7 - reg: Should contain audio registers location and length

8 - interrupts: Should contain the interrupt for the controller.

9 - clocks: Must contain an entry for each entry in clock-names.

10 Please refer to clock-bindings.txt.

11 - clock-names: One of each entry matching the clocks phandles list:

12 - "i2sclk" (generated clock) Required.

13 - "i2sosc" (fixed 200MHz clock) Required.

15 (1) : The generated clock is required only when any of TX and RX

16 works on Master Mode.

17 (2) : The fixed 200MHz clock is from internal chip and always on

19 Example:

21 i2s: bcm63xx-i2s {

22 #address-cells = <1>;

23 #size-cells = <0>;

24 compatible = "brcm,bcm63xx-i2s";

25 reg = <0xFF802080 0xFF>;

26 interrupts = <GIC_SPI 84 IRQ_TYPE_LEVEL_HIGH>;

27 clocks = <&i2sclk>, <&osc>;

28 clock-names = "i2sclk","i2sosc";

29 };

3. 한국어 전문 번역

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

BCM63xx I2S 필수 속성

1-14

Broadcom DSL/PON BCM63xx Audio I2S controller의 `compatible`은 `brcm,bcm63xx-i2s`입니다. `#address-cells`는 32-bit 값 한 cell, `#size-cells`는 0 cell입니다.

`reg`는 audio register 위치와 길이, `interrupts`는 controller interrupt입니다. `clocks`는 `clock-names`의 각 항목에 대응하는 phandle을 담습니다.

필수 clock 이름은 generated clock인 `i2sclk`와 internal fixed 200MHz clock인 `i2sosc`입니다.

Master mode clock 조건

15-18

generated clock은 TX 또는 RX 중 하나라도 Master Mode로 동작할 때만 필요합니다. fixed 200MHz clock은 chip 내부에서 제공되며 항상 켜져 있습니다.

BCM63xx I2S 예제

19-29

예제는 register, level-high interrupt, generated·fixed clock과 두 clock name을 정의합니다.

i2s: bcm63xx-i2s {
        #address-cells = <1>;
        #size-cells = <0>;
        compatible = "brcm,bcm63xx-i2s";
        reg = <0xFF802080 0xFF>;
        interrupts = <GIC_SPI 84 IRQ_TYPE_LEVEL_HIGH>;
        clocks = <&i2sclk>, <&osc>;
        clock-names = "i2sclk","i2sosc";
};