Documentation/devicetree/bindings/dma/k3dma.txt GitHub 원문 ↗

Linux 6.18.37 · Devicetree Bindings

Hisilicon K3 DMA

K3 physical/virtual channel과 request-line client 바인딩입니다.

Source pathDocumentation/devicetree/bindings/dma/k3dma.txt
Source versionLinux v6.18.37
TranslationDUJINLABS 전문 번역 + 해설

요약·해설, 영어 원문, 전체 번역을 구분해 실었습니다. API 이름, 코드 심벌, 소스 경로는 원문 표기를 유지합니다.

1. 요약·해설

원문의 핵심 내용을 정리하고 커널 프로그래밍에 필요한 설명을 덧붙였습니다. 아래의 전체 번역과는 별도로 작성한 해설입니다.

요약과 해설

k3dma.txt:1-47

Shared interrupt와 I2C request line 예제를 설명합니다.

2. 영어 원문 전체

번역에 사용한 Linux v6.18.37 원문입니다. 줄 번호는 해당 버전의 소스 파일을 기준으로 합니다.

원문 전체 펼치기
1 * Hisilicon K3 DMA controller
2
3 See dma.txt first
4
5 Required properties:
6 - compatible: Must be one of
7 - "hisilicon,k3-dma-1.0"
8 - "hisilicon,hisi-pcm-asp-dma-1.0"
9 - reg: Should contain DMA registers location and length.
10 - interrupts: Should contain one interrupt shared by all channel
11 - #dma-cells: see dma.txt, should be 1, para number
12 - dma-channels: physical channels supported
13 - dma-requests: virtual channels supported, each virtual channel
14 have specific request line
15 - clocks: clock required
16
17 Example:
18
19 Controller:
20 dma0: dma@fcd02000 {
21 compatible = "hisilicon,k3-dma-1.0";
22 reg = <0xfcd02000 0x1000>;
23 #dma-cells = <1>;
24 dma-channels = <16>;
25 dma-requests = <27>;
26 interrupts = <0 12 4>;
27 clocks = <&pclk>;
28 };
29
30 Client:
31 Use specific request line passing from dmax
32 For example, i2c0 read channel request line is 18, while write channel use 19
33
34 i2c0: i2c@fcb08000 {
35 compatible = "snps,designware-i2c";
36 dmas = <&dma0 18 /* read channel */
37 &dma0 19>; /* write channel */
38 dma-names = "rx", "tx";
39 };
40
41 i2c1: i2c@fcb09000 {
42 compatible = "snps,designware-i2c";
43 dmas = <&dma0 20 /* read channel */
44 &dma0 21>; /* write channel */
45 dma-names = "rx", "tx";
46 };
47
48

3. 한국어 전문 번역

영어 원문의 문단 순서와 의미에 맞춰 전체 내용을 번역했습니다. 코드, 함수명, 코드 심벌, URL은 원문 표기를 유지합니다.

Hisilicon K3 DMA 속성

1-16

Hisilicon K3 DMA controller 바인딩이며 먼저 `dma.txt`를 참조합니다. `compatible`은 `hisilicon,k3-dma-1.0` 또는 `hisilicon,hisi-pcm-asp-dma-1.0`입니다.

`reg`는 DMA register 위치와 길이, `interrupts`는 모든 channel이 공유하는 하나의 interrupt입니다. `#dma-cells`는 1이며 parameter number를 전달합니다. `dma-channels`는 physical channel 수, `dma-requests`는 특정 request line을 가진 virtual channel 수, `clocks`는 필수 clock입니다.

K3 physical/virtual DMA channel
Client request line#dma-cells = 1
Virtual DMA requestdma-requests
Physical channeldma-channels
Shared interruptAll channels

Virtual request line이 shared interrupt를 사용하는 physical channel에 매핑됩니다.

K3 DMA controller 예제

17-29

예제 controller는 register 영역, 16 physical channel, 27 virtual request, shared interrupt와 peripheral clock을 선언합니다.

dma0: dma@fcd02000 {
        compatible = "hisilicon,k3-dma-1.0";
        reg = <0xfcd02000 0x1000>;
        #dma-cells = <1>;
        dma-channels = <16>;
        dma-requests = <27>;
        interrupts = <0 12 4>;
        clocks = <&pclk>;
};

I2C request-line client 예제

30-47

Client는 DMA controller에서 전달된 특정 request line을 사용합니다. I2C0 read/write는 18/19, I2C1 read/write는 20/21이며 `dma-names`는 `rx`, `tx`입니다.

i2c0: i2c@fcb08000 {
        compatible = "snps,designware-i2c";
        dmas =        <&dma0 18          /* read channel */
                 &dma0 19>;        /* write channel */
        dma-names = "rx", "tx";
};

i2c1: i2c@fcb09000 {
        compatible = "snps,designware-i2c";
        dmas =        <&dma0 20          /* read channel */
                 &dma0 21>;        /* write channel */
        dma-names = "rx", "tx";
};