DMA registers: Difference between revisions
Rainwarrior (talk | contribs) (→DMAPn - DMA/HDMA parameters ($43n0 read/write) (n = 0..7): pattern 5 is also an undocumented duplicate) |
Rainwarrior (talk | contribs) (→DMAPn - DMA/HDMA parameters ($43n0 read/write) (n = 0..7): pattern 7 seems to have an error, should be same as 3 according to fullsnes? (correct my error making 5 symmetrical, the length is important for HDMA)) |
||
Line 122: | Line 122: | ||
| 4 || 4 || <tt style="white-space: nowrap">xx+0 xx+1 xx+2 xx+3</tt> || Window | | 4 || 4 || <tt style="white-space: nowrap">xx+0 xx+1 xx+2 xx+3</tt> || Window | ||
|- | |- | ||
| 5 || 4 || <tt style="white-space: nowrap">xx+0 xx+1</tt> || | | 5 || 4 || <tt style="white-space: nowrap">xx+0 xx+1 xx+0 xx+1</tt> || | ||
|- | |- | ||
| 6 || 2 || <tt style="white-space: nowrap">xx+0 xx+0</tt> || Same as 2, undocumented | | 6 || 2 || <tt style="white-space: nowrap">xx+0 xx+0</tt> || Same as 2, undocumented | ||
|- | |- | ||
| 7 || 4 || <tt style="white-space: nowrap">xx+0 xx+ | | 7 || 4 || <tt style="white-space: nowrap">xx+0 xx+0 xx+1 xx+1</tt> || Same as 3, undocumented | ||
|} | |} | ||
Revision as of 19:04, 24 May 2022
The SNES's DMA (Direct Memory Access) unit allows a game to copy graphics, palettes, OAM and more at a much higher speed than the CPU can accomplish alone. This allows a game to make better use of the limited amount of time it has in vblank to change graphical memory.
The SNES has two address buses - consisting of the A bus (which contains cartridge ROM, cartridge RAM, and the SNES's RAM) and the B bus (anything in the $2100-$21ff range, including PPU registers and APU registers). DMA always involves copying something from one of these two buses to something on the other bus.
DMA cannot copy from one area of the SNES's RAM to another, even if RAM is specified as both the source and destination. For that, the MVN
and MVP
instructions are probably the best available choice.
The SNES also features HDMA which runs in the background and can be set up to automatically write values to hardware registers at specific scanlines, allowing for effects.
These registers are always accessed at 3.58 MHz! That means that any channels that are not currently in use can have their registers repurposed for a small amount of fast RAM.
Name | Address | Bits | Type | Notes |
---|---|---|---|---|
MDMAEN | $420B | 7654 3210 | W8 | DMA enable. |
HDMAEN | $420C | 7654 3210 | W8 | HDMA enable. |
DMAPn | $43n0 | DI.A APPP | RW8 | Direction (D), indirect HDMA (I), address increment mode (A), transfer pattern (P). |
BBADn | $43n1 | AAAA AAAA | RW8 | B-bus address. |
A1TnL A1TnH A1Bn |
$43n2 $43n3 $43n4 |
LLLL LLLL HHHH HHHH BBBB BBBB |
RW24 | DMA source address / HDMA table start address. |
DASnL DASnH DASBn |
$43n5 $43n6 $43n7 |
LLLL LLLL HHHH HHHH BBBB BBBB |
RW24 | DMA byte count (H:L) / HDMA indirect table address (B:H:L). |
A2AnL A2AnH |
$43n8 $43n9 |
LLLL LLLL HHHH HHHH |
RW16 | HDMA table current address within bank (H:L). |
NLTRn | $43nA | RLLL LLLL | RW8 | HDMA reload flag (R) and scanline counter (L). |
UNUSEDn | $43nB $43nF |
DDDD DDDD | RW8 | Unused shared data byte (D). |
table source |
Register types:
- R - Readable
- W - Writeable
- 8 - 8-bit access only
- 16 - 8-bit access to either address, or 16-bit access to the lower address.
- 24 - 8-bit or 16-bit access to 3 registers.
DMA channels
The SNES contains 8 separate DMA "channels" - each one contains a set of parameters to configure a DMA transfers. They are configured with registers in the $4300-$437f range, where the first 16 addresses correspond to the first register, the second 16 addresses correspond to the next, and so on.
MDMAEN - Start DMA transfer ($420B write)
7 bit 0 ---- ---- 7654 3210 |||| |||| |||| |||+- Channel 0 select |||| ||+-- Channel 1 select |||| |+--- Channel 2 select |||| +---- Channel 3 select |||+------ Channel 4 select ||+------- Channel 5 select |+-------- Channel 6 select +--------- Channel 7 select
Upon writing to this register, a DMA transfer is started for each bit that was set, starting with the lowest selected channel number up toward the highest. The CPU is stopped until all transfers have completed. If an HDMA transfer happens while the DMA transfer is going, the DMA transfer will be temporarily paused to allow the HDMA transfer to happen.
HDMAEN - Enable HDMA transfers ($420C write)
7 bit 0 ---- ---- 7654 3210 |||| |||| |||| |||+- Channel 0 HDMA enable |||| ||+-- Channel 1 HDMA enable |||| |+--- Channel 2 HDMA enable |||| +---- Channel 3 HDMA enable |||+------ Channel 4 HDMA enable ||+------- Channel 5 HDMA enable |+-------- Channel 6 HDMA enable +--------- Channel 7 HDMA enable
This register enables HDMA for the selected channels.
DMA channel registers
DMAPn - DMA/HDMA parameters ($43n0 read/write) (n = 0..7)
7 bit 0 ---- ---- DIxA APPP |||| |||| |||| |+++- Transfer pattern (see below) |||+-+---- Address adjust mode (DMA only): ||| 0: Increment A bus address after copy ||| 1/3: Fixed ||| 2: Decrement A bus address after copy ||+------- Unused |+-------- Indirect (HDMA only) +--------- Direction: 0=Copy from A to B, 1=Copy from B to A
The "transfer pattern" affects how many bytes are transferred each scanline in HDMA. For DMA, it allows copying to VRAM, which requires writing to two alternating addresses.
Pattern | Number of bytes | B Bus address | Usage example |
---|---|---|---|
0 | 1 | xx+0 | WRAM, Mode 7 graphics/tilemap |
1 | 2 | xx+0 xx+1 | VRAM |
2 | 2 | xx+0 xx+0 | OAM, CGRAM, equivalent to 0 |
3 | 4 | xx+0 xx+0 xx+1 xx+1 | Scroll positions, Mode 7 parameters |
4 | 4 | xx+0 xx+1 xx+2 xx+3 | Window |
5 | 4 | xx+0 xx+1 xx+0 xx+1 | |
6 | 2 | xx+0 xx+0 | Same as 2, undocumented |
7 | 4 | xx+0 xx+0 xx+1 xx+1 | Same as 3, undocumented |
BBADn - B-bus address ($43n1 read/write) (n = 0..7)
7 bit 0 ---- ---- AAAA AAAA |||| |||| ++++-++++- Selects a hardware register to read or write from, in the $2100-$21ff range
UNUSEDn - Unused byte ($43nB and $43nF read/write) (n = 0..7)
7 bit 0 ---- ---- NNNN NNNN |||| |||| ++++-++++- One unused byte available through two different addresses
Seems to have no effect on DMA or HDMA, and this register cannot be used as a source for a DMA fill.
Configuration registers (DMA)
A1TnL, A1TnH, A1Bn - DMA Current Address ($43n2, $43n3, $43n4 read/write) (n = 0..7)
A1Bn A1TnH A1TnL $43n4 $43n3 $43n2 7 bit 0 7 bit 0 7 bit 0 ---- ---- ---- ---- ---- ---- BBBB BBBB HHHH HHHH LLLL LLLL |||| |||| |||| |||| |||| |||| ++++-++++---++++-++++---++++-++++- Address on the A bus
The low 16-bits of this address change as the DMA happens, but the bank byte is fixed. DMA can not cross banks.
HDMA uses these registers for its table address instead.
DASnL, DASnH - DMA Byte-Counter ($43n5, $43n6 read/write) (n = 0..7)
DASnH DASnL $43n6 $43n5 7 bit 0 7 bit 0 ---- ---- ---- ---- HHHH HHHH LLLL LLLL |||| |||| |||| |||| ++++-++++---++++-++++- 16-bit number that indicates how many bytes to transfer
A byte count of zero means 65536 bytes.
This byte count is not affected by the DMA pattern. The SNES will stop before a pattern is completed if it runs out of bytes.
Once the DMA finishes, these registers will be zero.
HDMA uses these registers for its indirect address instead.
Configuration registers (HDMA)
A1TnL, A1TnH, A1Bn - HDMA Table Start Address ($43n2, $43n3, $43n4 read/write) (n = 0..7)
A1Bn A1TnH A1TnL $43n4 $43n3 $43n2 7 bit 0 7 bit 0 7 bit 0 ---- ---- ---- ---- ---- ---- BBBB BBBB HHHH HHHH LLLL LLLL |||| |||| |||| |||| |||| |||| ++++-++++---++++-++++---++++-++++- 24-bit little-endian address on the A bus
These registers control where the channel's HDMA table is. This address gets copied into $43n8 and $43n9 every frame.
DASBn - Indirect HDMA Bank ($43n7 read/write) (n = 0..7)
7 bit 0 ---- ---- BBBB BBBB |||| |||| ++++-++++- High byte (bank) of HDMA indirect address
This must be set manually by the program to control the indirect HDMA bank. (DASnL/DASnH are automatically updated from the table.)
Other HDMA registers
These keep track of each channel's state as HDMA is happening.
DASnL, DASnH, DASBn - Indirect HDMA Address ($43n5, $43n6, $43n7 read/write) (n = 0..7)
DASBn DASnH DASnL $43n7 $43n6 $43n5 7 bit 0 7 bit 0 7 bit 0 ---- ---- ---- ---- --------- BBBB BBBB HHHH HHHH LLLL LLLL |||| |||| |||| |||| |||| |||| ++++-++++---++++-++++---++++-++++- The current indirect DMA address.
With indirect HDMA, if the repeat bit is set in the table entry, then the SNES will continue to read increasing addresses starting from the one given in the table, using these registers to keep track of where it currently is.
The low 16 bits are automatically copied from the table, but the bank byte DASBn must be manually set by the program. The bank byte is fixed, and HDMA will not cross banks.
A2AnL, A2AnH - HDMA Table Current Address ($43n8, $43n9 read/write) (n = 0..7)
A2AnH A2AnL $43n9 $43n8 7 bit 0 7 bit 0 ---- ---- ---- ---- HHHH HHHH LLLL LLLL |||| |||| |||| |||| ++++-++++---++++-++++- Low 16 bits of the current address within the HDMA table
Bank byte is taken from $43n4, as it does not change.
NTRLn - HDMA Line-Counter ($43nA read/write) (n = 0..7)
7 bit 0 ---- ---- RLLL LLLL |||| |||| |+++-++++- Number of scanlines left +--------- Repeat flag
Automatically loaded from the table. Scanline count is decremented every scanline until it hits zero.
HDMA table format
HDMA tables specify what values to write to the selected B bus register, as well as which scanlines to write the values on. The tables can either directly contain the values (Direct mode) or specify 16-bit pointers that are then used to get the values (Indirect mode).
Direct HDMA table entries
1 byte - Line count, and repeat mode N bytes - Data
The number of bytes in each Data section is determined by the pattern chosen for the channel in register $43n0.
- If repeat mode is off, one pattern's worth of bytes are written, then the SNES waits for the specified number of scanlines before continuing onto the next table entry.
- If repeat mode is on, then the total size of the data section is the number of scanlines multiplied by the number of bytes in the pattern. One pattern's worth of bytes are written for however many scanlines indicated in the table.
Indirect HDMA table entries
1 byte - Line count, and repeat mode 2 bytes - Pointer to access the data through
- If repeat mode is off, one pattern's worth of bytes are written from an address starting from the pointer given.
- If repeat mode is on, the SNES continues to progress through the bytes that the pointer points to, for however many scanlines are indicated in the table.
Line count, repeat mode byte
Possible values for the "Line count, and repeat mode" byte are as follows:
- $00: Stop processing HDMA on that channel for the rest of the frame.
- $01-$80: Write once, then wait for X-1 scanlines
- $81-$FF: Write every scanline for X-$80 scanlines, repeat mode