SNES DMA (Direct Memory Access) More...

#include <snes/types.h>

Functions
void	dmaClearVRAM (void)
	Clear all VRAM to zero.

void	dmaCopyCGram (u8 *source, u16 startColor, u16 size)
	Copy palette data to CGRAM (PVSnesLib compatible)

void	dmaCopyCGramBank (u8 *source, u8 bank, u16 startColor, u16 size)
	Copy palette data to CGRAM with explicit source bank byte.

void	dmaCopyOam (u8 *source, u16 size)
	Copy OAM data (PVSnesLib compatible)

void	dmaCopyVram (u8 *source, u16 vramAddr, u16 size)
	Copy data to VRAM (PVSnesLib compatible)

void	dmaCopyVramBank (u8 *source, u8 bank, u16 vramAddr, u16 size)
	Copy data to VRAM with explicit source bank byte.

void	dmaCopyVramMode7 (u8 tilemap, u16 tilemapSize, u8 tiles, u16 tilesSize)
	Load Mode 7 interleaved data to VRAM.

void	dmaFillVRAM (u16 value, u16 dest, u16 size)
	Set VRAM to a value.

void	dmaTransfer (u8 channel, u8 mode, u8 srcBank, u16 srcAddr, u8 destReg, u16 size)
	Perform generic DMA transfer.

Detailed Description

SNES DMA (Direct Memory Access)

Functions for fast memory transfers using DMA.

DMA Overview

DMA allows fast transfers between:

Work RAM ↔ VRAM (video RAM)
Work RAM ↔ CGRAM (palette RAM)
Work RAM ↔ OAM (sprite RAM)

DMA is much faster than CPU copying and should be used for all bulk transfers during VBlank.

VBlank Timing Requirement

Warning: CRITICAL: VRAM, CGRAM, and OAM can only be safely accessed during VBlank (vertical blanking period) or when the screen is in force blank mode (INIDISP bit 7 set). Accessing these memories during active display causes visual corruption and undefined behavior.; VBlank Budget: You have approximately 2,200 CPU cycles during VBlank for DMA transfers. This translates to roughly 4KB of data that can be safely transferred per frame. While the theoretical maximum is higher, 4KB is a safe practical limit that accounts for NMI handler overhead.

Bank Limitation

Note: The current implementation assumes source data is in bank $00 for ROM addresses. Data in SUPERFREE sections beyond bank 0 requires using dmaCopyVramBank() or dmaCopyCGramBank() with an explicit bank parameter.

Author: OpenSNES Team

Copyright: MIT License

Function Documentation

◆ dmaClearVRAM()

void dmaClearVRAM ( void )

Clear all VRAM to zero.

Clears all 64KB of VRAM. Should be called during force blank.

◆ dmaCopyCGram()

void dmaCopyCGram	(	u8 *	source,
		u16	startColor,
		u16	size
	)

Copy palette data to CGRAM (PVSnesLib compatible)

Copies palette data from ROM or RAM to CGRAM using DMA.

Parameters

source	Source address (can be ROM or RAM)
startColor	Starting color index (0-255)
size	Number of bytes to copy (2 bytes per color)

extern char palette[];
WaitForVBlank();
dmaCopyCGram(palette, 0, 32);  // 16 colors * 2 bytes

Warning: Must be called during VBlank or force blank! Calling during active display causes palette corruption.

Note: Source data must be in bank $00. For data in other banks, use dmaCopyCGramBank() with an explicit bank parameter.

◆ dmaCopyCGramBank()

void dmaCopyCGramBank	(	u8 *	source,
		u8	bank,
		u16	startColor,
		u16	size
	)

Copy palette data to CGRAM with explicit source bank byte.

Same as dmaCopyCGram() but allows specifying the ROM bank for data in banks other than $00 (e.g., SUPERFREE sections placed by linker).

Parameters

source	Source address (16-bit offset within bank)
bank	Source bank byte ($00-$3F for LoROM, $00-$7D for HiROM)
startColor	Starting color index (0-255)
size	Number of bytes to transfer (2 bytes per color)

Warning: Must be called during VBlank or force blank!

◆ dmaCopyOam()

void dmaCopyOam	(	u8 *	source,
		u16	size
	)

Copy OAM data (PVSnesLib compatible)

Parameters

source	Source address (544 bytes)
size	Number of bytes to copy (usually 544)

dmaCopyOam(oamBuffer, 544);

dmaCopyOam

void dmaCopyOam(u8 *source, u16 size)

Copy OAM data (PVSnesLib compatible)

◆ dmaCopyVram()

void dmaCopyVram	(	u8 *	source,
		u16	vramAddr,
		u16	size
	)

Copy data to VRAM (PVSnesLib compatible)

Copies data from ROM or RAM to VRAM using DMA. This function handles 24-bit source addresses, so it works with ROM data defined via extern.

Parameters

source	Source address (can be ROM or RAM)
vramAddr	Destination word address in VRAM
size	Number of bytes to copy

extern char tileset[];
extern char tileset_end[];
WaitForVBlank();
dmaCopyVram(tileset, 0x0000, tileset_end - tileset);

Warning: Must be called during VBlank or force blank! Calling during active display causes visual corruption.

Note: Source data must be in bank $00 (LoROM $00:8000-$FFFF). For data in other banks, use dmaCopyVramBank().

◆ dmaCopyVramBank()

void dmaCopyVramBank	(	u8 *	source,
		u8	bank,
		u16	vramAddr,
		u16	size
	)

Copy data to VRAM with explicit source bank byte.

Same as dmaCopyVram() but allows specifying the ROM bank for data in banks other than $00 (e.g., SUPERFREE sections placed by linker).

Parameters

source	Source address (16-bit offset within bank)
bank	Source bank byte ($00-$3F for LoROM, $00-$7D for HiROM)
vramAddr	VRAM destination word address
size	Number of bytes to transfer

Warning: Must be called during VBlank or force blank!

◆ dmaCopyVramMode7()

void dmaCopyVramMode7	(	u8 *	tilemap,
		u16	tilemapSize,
		u8 *	tiles,
		u16	tilesSize
	)

Load Mode 7 interleaved data to VRAM.

Mode 7 stores tilemap in VRAM low bytes and tile pixels in VRAM high bytes. This function performs two DMA transfers with appropriate VMAIN settings:

Tilemap -> VMDATAL (VMAIN=$00, increment after low byte)
Tiles -> VMDATAH (VMAIN=$80, increment after high byte)

VRAM destination is always $0000 (Mode 7 uses the full 32K word space).

Parameters

tilemap	Tilemap data source (.mp7 file, 128x128 = 16384 bytes)
tilemapSize	Tilemap data size in bytes
tiles	Tile pixel data source (.pc7 file, 256 tiles x 64 bytes)
tilesSize	Tile pixel data size in bytes

Warning: Must be called during forced blank (INIDISP=$80) or VBlank.

◆ dmaFillVRAM()

void dmaFillVRAM	(	u16	value,
		u16	dest,
		u16	size
	)

Set VRAM to a value.

Parameters

value	Value to fill (repeated as word)
dest	Destination word address in VRAM
size	Number of bytes to fill (0 = 65536)

◆ dmaTransfer()

void dmaTransfer	(	u8	channel,
		u8	mode,
		u8	srcBank,
		u16	srcAddr,
		u8	destReg,
		u16	size
	)

Perform generic DMA transfer.

Parameters

channel	DMA channel (0-7)
mode	DMA mode byte
srcBank	Source bank
srcAddr	Source address
destReg	Destination B-bus register
size	Transfer size