Documentation/devicetree/bindings/dma/renesas,nbpfaxi.txt GitHub 원문 ↗

Linux 6.18.37 · Devicetree Bindings

Renesas NBPFAXI DMA

NBPFAXI terminal/flag specifier와 burst limit 바인딩입니다.

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

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

1. 요약·해설

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

요약과 해설

renesas,nbpfaxi.txt:1-69

Compatible variant, request flag와 RX/TX client를 설명합니다.

2. 영어 원문 전체

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

원문 전체 펼치기
1 * Renesas "Type-AXI" NBPFAXI* DMA controllers
2
3 * DMA controller
4
5 Required properties
6
7 - compatible: must be one of
8 "renesas,nbpfaxi64dmac1b4"
9 "renesas,nbpfaxi64dmac1b8"
10 "renesas,nbpfaxi64dmac1b16"
11 "renesas,nbpfaxi64dmac4b4"
12 "renesas,nbpfaxi64dmac4b8"
13 "renesas,nbpfaxi64dmac4b16"
14 "renesas,nbpfaxi64dmac8b4"
15 "renesas,nbpfaxi64dmac8b8"
16 "renesas,nbpfaxi64dmac8b16"
17 - #dma-cells: must be 2: the first integer is a terminal number, to which this
18 slave is connected, the second one is flags. Flags is a bitmask
19 with the following bits defined:
20
21 #define NBPF_SLAVE_RQ_HIGH 1
22 #define NBPF_SLAVE_RQ_LOW 2
23 #define NBPF_SLAVE_RQ_LEVEL 4
24
25 Optional properties:
26 - max-burst-mem-read: limit burst size for memory reads
27 (DMA_MEM_TO_MEM/DMA_MEM_TO_DEV) to this value, specified in bytes, rather
28 than using the maximum burst size allowed by the hardware's buffer size.
29 - max-burst-mem-write: limit burst size for memory writes
30 (DMA_DEV_TO_MEM/DMA_MEM_TO_MEM) to this value, specified in bytes, rather
31 than using the maximum burst size allowed by the hardware's buffer size.
32 If both max-burst-mem-read and max-burst-mem-write are set, DMA_MEM_TO_MEM
33 will use the lower value.
34
35 You can use dma-channels and dma-requests as described in dma.txt, although they
36 won't be used, this information is derived from the compatibility string.
37
38 Example:
39
40 dma: dma-controller@48000000 {
41 compatible = "renesas,nbpfaxi64dmac8b4";
42 reg = <0x48000000 0x400>;
43 interrupts = <0 12 0x4
44 0 13 0x4
45 0 14 0x4
46 0 15 0x4
47 0 16 0x4
48 0 17 0x4
49 0 18 0x4
50 0 19 0x4>;
51 #dma-cells = <2>;
52 dma-channels = <8>;
53 dma-requests = <8>;
54 };
55
56 * DMA client
57
58 Required properties:
59
60 dmas and dma-names are required, as described in dma.txt.
61
62 Example:
63
64 #include <dt-bindings/dma/nbpfaxi.h>
65
66 ...
67 dmas = <&dma 0 (NBPF_SLAVE_RQ_HIGH | NBPF_SLAVE_RQ_LEVEL)
68 &dma 1 (NBPF_SLAVE_RQ_HIGH | NBPF_SLAVE_RQ_LEVEL)>;
69 dma-names = "rx", "tx";
70

3. 한국어 전문 번역

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

Renesas NBPFAXI controller 속성

1-37

Renesas Type-AXI NBPFAXI DMA controller 바인딩입니다. `compatible`은 `renesas,nbpfaxi64dmac1b4`, `renesas,nbpfaxi64dmac1b8`, `renesas,nbpfaxi64dmac1b16`, `renesas,nbpfaxi64dmac4b4`, `renesas,nbpfaxi64dmac4b8`, `renesas,nbpfaxi64dmac4b16`, `renesas,nbpfaxi64dmac8b4`, `renesas,nbpfaxi64dmac8b8`, `renesas,nbpfaxi64dmac8b16` variant 가운데 하나입니다.

`#dma-cells = <2>`이며 첫 integer는 slave가 연결된 terminal number, 두 번째는 flag bitmask입니다. `NBPF_SLAVE_RQ_HIGH`는 1, `NBPF_SLAVE_RQ_LOW`는 2, `NBPF_SLAVE_RQ_LEVEL`은 4입니다.

선택 `max-burst-mem-read`는 `DMA_MEM_TO_MEM`/`DMA_MEM_TO_DEV` memory read burst를 byte 단위로 제한하고, `max-burst-mem-write`는 `DMA_DEV_TO_MEM`/`DMA_MEM_TO_MEM` write burst를 제한합니다. 둘 다 설정하면 memory-to-memory transfer는 더 작은 값을 사용합니다.

`dma-channels`와 `dma-requests`를 `dma.txt` 형식으로 둘 수 있지만 사용되지는 않습니다. 이 정보는 compatible string에서 파생됩니다.

NBPFAXI DMA flag bit
FlagValue의미
NBPF_SLAVE_RQ_HIGH1High-polarity request
NBPF_SLAVE_RQ_LOW2Low-polarity request
NBPF_SLAVE_RQ_LEVEL4Level request

두 번째 DMA specifier cell에 넣는 request flag를 정리합니다.

NBPFAXI burst limit
DMA_MEM_TO_DEVmax-burst-mem-read
DMA_DEV_TO_MEMmax-burst-mem-write
DMA_MEM_TO_MEMmin(read limit, write limit)
NBPFAXI channelHardware-buffer bounded burst

Transfer direction에 따라 read/write 제한을 적용하며 memory-to-memory는 더 작은 값으로 제한합니다.

8-channel NBPFAXI 예제

38-55

예제 `renesas,nbpfaxi64dmac8b4` controller는 0x400-byte register 영역, interrupt 12부터 19까지 여덟 개, 2-cell specifier와 8 channel/8 request를 선언합니다.

dma: dma-controller@48000000 {
        compatible = "renesas,nbpfaxi64dmac8b4";
        reg = <0x48000000 0x400>;
        interrupts = <0 12 0x4
                      0 13 0x4
                      0 14 0x4
                      0 15 0x4
                      0 16 0x4
                      0 17 0x4
                      0 18 0x4
                      0 19 0x4>;
        #dma-cells = <2>;
        dma-channels = <8>;
        dma-requests = <8>;
};

NBPFAXI RX/TX client

56-69

DMA client에는 `dma.txt`에 설명된 `dmas`와 `dma-names`가 필요합니다. 예제는 `dt-bindings/dma/nbpfaxi.h`를 include하고 terminal 0/1에 `NBPF_SLAVE_RQ_HIGH | NBPF_SLAVE_RQ_LEVEL` flag를 적용해 RX/TX channel을 요청합니다.

#include <dt-bindings/dma/nbpfaxi.h>

...
                dmas = <&dma 0 (NBPF_SLAVE_RQ_HIGH | NBPF_SLAVE_RQ_LEVEL)
                        &dma 1 (NBPF_SLAVE_RQ_HIGH | NBPF_SLAVE_RQ_LEVEL)>;
                dma-names = "rx", "tx";