dma.h

Go to the documentation of this file.

#include "config.h"
#include "types.h"

#ifndef _DMA_H_
#define _DMA_H_


#define DMA_VRAM    0

#define DMA_CRAM    1

#define DMA_VSRAM   2

#define DMA_QUEUE_SIZE_DEFAULT          80
#define DMA_QUEUE_SIZE_MIN              32

#define DMA_TRANSFER_CAPACITY_NTSC      7200
#define DMA_TRANSFER_CAPACITY_PAL_LOW   8000
#define DMA_TRANSFER_CAPACITY_PAL_MAX   15000

#define DMA_BUFFER_SIZE_NTSC            DMA_TRANSFER_CAPACITY_NTSC
#define DMA_BUFFER_SIZE_PAL_LOW         DMA_TRANSFER_CAPACITY_PAL_LOW
#define DMA_BUFFER_SIZE_PAL_MAX         (14 * 1024)
#define DMA_BUFFER_SIZE_MIN             (2 * 1024)


typedef enum
{
    CPU = 0,            
    DMA = 1,            
    DMA_QUEUE = 2,      
    DMA_QUEUE_COPY = 3  
} TransferMethod;


typedef struct
{
    u16 regLenL;        // (newLen & 0xFF) | 0x9300;
    u16 regLenH;        // ((newLen >> 8) & 0xFF) | 0x9400;
    u32 regAddrMStep;   // (((addr << 7) & 0xFF0000) | 0x96008F00) + step;
    u32 regAddrHAddrL;  // ((addr >> 1) & 0x7F00FF) | 0x97009500;
    u32 regCtrlWrite;   // GFX_DMA_VRAMCOPY_ADDR(to)
} DMAOpInfo;


extern DMAOpInfo *dmaQueues;
extern u16* dmaDataBuffer;

void DMA_init();
void DMA_initEx(u16 size, u16 capacity, u16 bufferSize);

u16 DMA_getAutoFlush();
void DMA_setAutoFlush(bool value);
u16 DMA_getMaxQueueSize();
void DMA_setMaxQueueSize(u16 value);
void DMA_setMaxQueueSizeToDefault();
u16 DMA_getMaxTransferSize();
void DMA_setMaxTransferSize(u16 value);
void DMA_setMaxTransferSizeToDefault();
u16 DMA_getBufferSize();
void DMA_setBufferSize(u16 value);
void DMA_setBufferSizeToDefault();
u16 DMA_getIgnoreOverCapacity();
void DMA_setIgnoreOverCapacity(bool value);

void DMA_clearQueue();
void DMA_flushQueue();

u16 DMA_getQueueSize();
u16 DMA_getQueueTransferSize();

void* DMA_allocateTemp(u16 len);
void DMA_releaseTemp(u16 len);

bool DMA_transfer(TransferMethod tm, u8 location, void* from, u16 to, u16 len, u16 step);

bool DMA_canQueue(u8 location, u16 len);
void* DMA_allocateAndQueueDma(u8 location, u16 to, u16 len, u16 step);
bool DMA_copyAndQueueDma(u8 location, void* from, u16 to, u16 len, u16 step);
bool DMA_queueDma(u8 location, void* from, u16 to, u16 len, u16 step);
bool DMA_queueDmaFast(u8 location, void* from, u16 to, u16 len, u16 step);

void DMA_doDma(u8 location, void* from, u16 to, u16 len, s16 step);
void DMA_doDmaFast(u8 location, void* from, u16 to, u16 len, s16 step);

void DMA_doCPUCopy(u8 location, void* from, u16 to, u16 len, s16 step);
void DMA_doCPUCopyDirect(u32 cmd, void* from, u16 len, s16 step);

void DMA_doVRamFill(u16 to, u16 len, u8 value, s16 step);
void DMA_doVRamCopy(u16 from, u16 to, u16 len, s16 step);

void DMA_waitCompletion();


#endif // _DMA_H_