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

// better to allocate a bit more than DMA capacity
#define DMA_BUFFER_SIZE_NTSC            8192
#define DMA_BUFFER_SIZE_PAL_LOW         8192
#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;   // VDP_DMA_VRAMCOPY_ADDR(to)
} DMAOpInfo;


extern DMAOpInfo *dmaQueues;
extern u16* dmaDataBuffer;

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

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

void DMA_clearQueue(void);
void DMA_flushQueue(void);

u16 DMA_getQueueSize(void);
u16 DMA_getQueueTransferSize(void);

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(void);


#endif // _DMA_H_