Table of Contents
DMA
The gamepad features 5 DMA channels. The first two channels are intended for communication with peripherals such as SPI and IR, while the three last are general DMA channels suitable for uses such as blitting graphics to the framebuffer.
The base I/O addresses for the DMA channels are as follows:
Address | Desc. |
---|---|
0xF0004000 | General DMA registers |
0xF0004040 | DMA0 - peripheral |
0xF0004060 | DMA1 - peripheral |
0xF0004100 | DMA2 - general purpose |
0xF0004140 | DMA3 - general purpose |
0xF0004180 | DMA4 - general purpose |
The DMA channels trigger the following IRQs upon completion:
Channel | IRQ |
---|---|
DMA0 | 0x08 |
DMA1 | 0x09 |
DMA2 | 0x0D |
DMA3 | 0x0E |
DMA4 | 0x0C |
General registers
Address | Desc. |
---|---|
0xF0004000 | General DMA enable |
0xF0004000
General DMA enable.
Bits | Desc. |
---|---|
2-7 | ?? cleared upon init |
15 | Presumably DMA enable |
DMA0/1
These DMA channels are intended for communication with peripherals such as SPI and IR. They transfer data from memory to a peripheral, or the other way around.
Offset | Desc. |
---|---|
0x00 | Start/stop |
0x04 | Transfer control |
0x08 | ?? |
0x0C | ?? |
0x10 | Total byte count minus one |
0x14 | Memory address |
Base+0x00
DMA start/stop.
Bits | Desc. |
---|---|
0 | Start transfer / Busy |
1 | Stop transfer |
Bit 0 remains set while the transfer is in progress. Bit 1 may be used to stop the transfer at any point.
Base+0x04
Controls various aspects of the DMA transfer.
Bits | Desc. |
---|---|
0 | Direction; 0=read from peripheral, 1=write to peripheral |
1-3 | Peripheral select |
The peripheral select determines which peripheral is accessed. The following values are observed in the stock firmware:
Value | Desc. |
---|---|
0 | ?? |
2 | SPI |
3 | ?? |
4 | ?? |
6 | IR |
Note that the peripheral must be configured correctly for the DMA transfer to work, ie. for SPI, the transfer direction in 0xF0004404 must match that of the DMA channel, and so on.
Base+0x10
Total byte count minus one. This register is updated as the transfer progresses.
This register is 20 bits wide. When the transfer has completed, it reads as 0xFFFFF.
Base+0x14
Memory address. This register is updated as the transfer progresses.
DMA2/3/4
General purpose DMA channels. They are intended for blitting graphics to the screen, but may also be used for general memory fill/copy operations. They are quite faster than doing copy loops on the CPU.
Offset | Desc. |
---|---|
0x00 | Start/stop |
0x04 | Transfer control |
0x08 | Chunk size |
0x0C | Source buffer stride |
0x10 | Destination buffer stride |
0x14 | Total byte count minus one |
0x18 | Source address |
0x1C | Destination address |
0x20 | Fill value 1 |
0x24 | Fill value 2 |
Base+0x00
DMA start/stop.
Bits | Desc. |
---|---|
0 | Start transfer / Busy |
1 | Stop transfer |
Bit 0 remains set while the transfer is in progress. Bit 1 may be used to stop the transfer at any point.
Base+0x04
Controls various aspects of the DMA transfer.
Bits | Desc. |
---|---|
0 | Reverse byte order in each 16-byte block |
1 | Reverse byte order in each 8-byte block |
2-5 | Source address control |
6 | Fill unit; 0=8-bit, 1=16-bit |
7 | Masked fill mode |
8 | Background for masked fill mode; 0=use fill value 2, 1=do not fill |
9 | Bit order for masked fill mode; 0=MSb first, 1=LSb first |
10 | Simple fill mode (has priority over bit 7) |
18 | Double source increment every 8 bytes |
The source address control specifies how the source address is handled during the transfer. Individual bits seem to control individual parts of the address. The useful values are as follows:
Value | Desc. |
---|---|
0x0 | Fill destination with 0x00 |
0x3 | Decrement source address |
0xC | Increment source address |
0xF | Fill destination with 0xFF |
Simple fill mode ignores the source address and fills the destination with fill value 1.
Masked fill mode uses the source data to determine how to fill the destination. Each byte read from the source address is used as a mask for the next 8 destination units. If a mask bit is 1, fill value 1 is used. If a mask bit is 0, either fill value 2 is used, or the destination data is left unchanged (see bit 8).
Not yet known if there is a way to do a masked copy.
Base+0x08
Chunk size, ie. size in bytes of each line to copy/fill.
Base+0x0C
Source buffer stride, ie. byte offset between each line in the source buffer.
In simple fill mode, this register is ignored.
In masked fill mode, this register is ignored. The mask buffer stride must be 1/8th of the destination buffer stride.
Base+0x10
Destination buffer stride, ie. byte offset between each line in the destination buffer.
Base+0x14
Total byte count minus one. This register is updated as the transfer progresses.
This register is 24 bits wide. When the transfer has completed, it reads as 0xFFFFFF.
Base+0x18
Source address. This register is updated as the transfer progresses.
In simple fill mode, this register is ignored.
Base+0x1C
Destination address. This register is updated as the transfer progresses.
Base+0x20
Fill value 1. Used in simple fill mode, and in masked fill mode where the mask is 1.
Base+0x24
Fill value 2. Used in masked fill mode where the mask is 0.