Hisilicon K3 DMA | Linux 6.18.37

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

1. 요약·해설

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

요약과 해설

k3dma.txt:1-47

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

2. 영어 원문 전체

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

원문 전체 펼치기

1 * Hisilicon K3 DMA controller

3 See dma.txt first

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

17 Example:

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 };

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

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 };

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 };

3. 한국어 전문 번역

영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 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";
};