mirror of
https://github.com/zeldaret/oot
synced 2026-09-02 10:01:38 -04:00
Dragorn421
6c29db8fa6
* Document an includes style, apply to z_demo.c and z_play.c * "reverse" style includes * bss * clarify what a "main header" is * Update docs/includes.md Co-authored-by: Tharo <tharo10600@gmail.com> * Update docs/includes.md --------- Co-authored-by: Tharo <tharo10600@gmail.com>
62 lines
2.3 KiB
C
Executable File
62 lines
2.3 KiB
C
Executable File
#ifndef DMA_H
|
|
#define DMA_H
|
|
|
|
#include "ultra64.h"
|
|
#include "alignment.h"
|
|
#include "romfile.h" // IWYU pragma: export
|
|
|
|
typedef struct DmaRequest {
|
|
/* 0x00 */ uintptr_t vromAddr; // VROM address (source)
|
|
/* 0x04 */ void* dramAddr; // DRAM address (destination)
|
|
/* 0x08 */ size_t size; // File Transfer size
|
|
/* 0x0C */ const char* filename; // Filename for debugging
|
|
/* 0x10 */ int line; // Line number for debugging
|
|
/* 0x14 */ s32 unk_14;
|
|
/* 0x18 */ OSMesgQueue* notifyQueue; // Message queue for the notification message
|
|
/* 0x1C */ OSMesg notifyMsg; // Completion notification message
|
|
} DmaRequest; // size = 0x20
|
|
|
|
typedef struct DmaEntry {
|
|
/* 0x00 */ RomFile file;
|
|
/* 0x08 */ uintptr_t romStart;
|
|
/* 0x0C */ uintptr_t romEnd;
|
|
} DmaEntry;
|
|
|
|
extern DmaEntry gDmaDataTable[];
|
|
|
|
extern u32 gDmaMgrVerbose;
|
|
extern size_t gDmaMgrDmaBuffSize;
|
|
|
|
#define DMAMGR_DEFAULT_BUFSIZE ALIGN16(0x2000)
|
|
|
|
// Standard DMA Requests
|
|
|
|
s32 DmaMgr_RequestAsync(DmaRequest* req, void* ram, uintptr_t vrom, size_t size, u32 unk5, OSMesgQueue* queue,
|
|
OSMesg msg);
|
|
s32 DmaMgr_RequestSync(void* ram, uintptr_t vrom, size_t size);
|
|
#if DEBUG_FEATURES
|
|
s32 DmaMgr_RequestAsyncDebug(DmaRequest* req, void* ram, uintptr_t vrom, size_t size, u32 unk5, OSMesgQueue* queue,
|
|
OSMesg msg, const char* file, int line);
|
|
s32 DmaMgr_RequestSyncDebug(void* ram, uintptr_t vrom, size_t size, const char* file, int line);
|
|
#endif
|
|
|
|
// Special-purpose DMA Requests
|
|
|
|
s32 DmaMgr_DmaRomToRam(uintptr_t rom, void* ram, size_t size);
|
|
void DmaMgr_DmaFromDriveRom(void* ram, uintptr_t rom, size_t size);
|
|
s32 DmaMgr_AudioDmaHandler(OSPiHandle* pihandle, OSIoMesg* mb, s32 direction);
|
|
|
|
// Initialization
|
|
|
|
void DmaMgr_Init(void);
|
|
|
|
#if DEBUG_FEATURES
|
|
#define DMA_REQUEST_SYNC(ram, vrom, size, file, line) DmaMgr_RequestSyncDebug(ram, vrom, size, file, line)
|
|
#define DMA_REQUEST_ASYNC(req, ram, vrom, size, unk5, queue, msg, file, line) DmaMgr_RequestAsyncDebug(req, ram, vrom, size, unk5, queue, msg, file, line)
|
|
#else
|
|
#define DMA_REQUEST_SYNC(ram, vrom, size, file, line) DmaMgr_RequestSync(ram, vrom, size)
|
|
#define DMA_REQUEST_ASYNC(req, ram, vrom, size, unk5, queue, msg, file, line) DmaMgr_RequestAsync(req, ram, vrom, size, unk5, queue, msg)
|
|
#endif
|
|
|
|
#endif
|