src/gba/gba.h (view raw)
1/* Copyright (c) 2013-2014 Jeffrey Pfau
2 *
3 * This Source Code Form is subject to the terms of the Mozilla Public
4 * License, v. 2.0. If a copy of the MPL was not distributed with this
5 * file, You can obtain one at http://mozilla.org/MPL/2.0/. */
6#ifndef GBA_H
7#define GBA_H
8
9#include "util/common.h"
10
11#include "arm.h"
12#include "debugger/debugger.h"
13
14#include "gba-memory.h"
15#include "gba-video.h"
16#include "gba-audio.h"
17#include "gba-sio.h"
18
19extern const uint32_t GBA_ARM7TDMI_FREQUENCY;
20
21enum GBAIRQ {
22 IRQ_VBLANK = 0x0,
23 IRQ_HBLANK = 0x1,
24 IRQ_VCOUNTER = 0x2,
25 IRQ_TIMER0 = 0x3,
26 IRQ_TIMER1 = 0x4,
27 IRQ_TIMER2 = 0x5,
28 IRQ_TIMER3 = 0x6,
29 IRQ_SIO = 0x7,
30 IRQ_DMA0 = 0x8,
31 IRQ_DMA1 = 0x9,
32 IRQ_DMA2 = 0xA,
33 IRQ_DMA3 = 0xB,
34 IRQ_KEYPAD = 0xC,
35 IRQ_GAMEPAK = 0xD
36};
37
38enum GBALogLevel {
39 GBA_LOG_FATAL = 0x01,
40 GBA_LOG_ERROR = 0x02,
41 GBA_LOG_WARN = 0x04,
42 GBA_LOG_INFO = 0x08,
43 GBA_LOG_DEBUG = 0x10,
44 GBA_LOG_STUB = 0x20,
45
46 GBA_LOG_GAME_ERROR = 0x100,
47 GBA_LOG_SWI = 0x200,
48
49 GBA_LOG_ALL = 0x33F,
50
51#ifdef NDEBUG
52 GBA_LOG_DANGER = GBA_LOG_ERROR
53#else
54 GBA_LOG_DANGER = GBA_LOG_FATAL
55#endif
56};
57
58enum GBAKey {
59 GBA_KEY_A = 0,
60 GBA_KEY_B = 1,
61 GBA_KEY_SELECT = 2,
62 GBA_KEY_START = 3,
63 GBA_KEY_RIGHT = 4,
64 GBA_KEY_LEFT = 5,
65 GBA_KEY_UP = 6,
66 GBA_KEY_DOWN = 7,
67 GBA_KEY_R = 8,
68 GBA_KEY_L = 9,
69 GBA_KEY_MAX,
70 GBA_KEY_NONE = -1
71};
72
73enum GBAComponent {
74 GBA_COMPONENT_DEBUGGER,
75 GBA_COMPONENT_MAX
76};
77
78struct GBA;
79struct GBARotationSource;
80struct Patch;
81struct VFile;
82
83struct GBATimer {
84 uint16_t reload;
85 uint16_t oldReload;
86 int32_t lastEvent;
87 int32_t nextEvent;
88 int32_t overflowInterval;
89 unsigned prescaleBits : 4;
90 unsigned countUp : 1;
91 unsigned doIrq : 1;
92 unsigned enable : 1;
93};
94
95struct GBA {
96 struct ARMComponent d;
97
98 struct ARMCore* cpu;
99 struct GBAMemory memory;
100 struct GBAVideo video;
101 struct GBAAudio audio;
102 struct GBASIO sio;
103
104 struct GBASync* sync;
105
106 struct ARMDebugger* debugger;
107
108 uint32_t bus;
109
110 int timersEnabled;
111 struct GBATimer timers[4];
112
113 int springIRQ;
114 uint32_t biosChecksum;
115 int* keySource;
116 uint32_t busyLoop;
117 struct GBARotationSource* rotationSource;
118 struct GBALuminanceSource* luminanceSource;
119 struct GBARTCSource* rtcSource;
120 struct GBARumble* rumble;
121
122 struct GBARRContext* rr;
123 void* pristineRom;
124 size_t pristineRomSize;
125 uint32_t romCrc32;
126 struct VFile* romVf;
127 struct VFile* biosVf;
128
129 const char* activeFile;
130
131 int logLevel;
132};
133
134struct GBACartridge {
135 uint32_t entry;
136 uint8_t logo[156];
137 char title[12];
138 uint32_t id;
139 uint16_t maker;
140 uint8_t type;
141 uint8_t unit;
142 uint8_t device;
143 uint8_t reserved[7];
144 uint8_t version;
145 uint8_t checksum;
146 // And ROM data...
147};
148
149void GBACreate(struct GBA* gba);
150void GBADestroy(struct GBA* gba);
151
152void GBAReset(struct ARMCore* cpu);
153void GBASkipBIOS(struct ARMCore* cpu);
154
155void GBATimerUpdateRegister(struct GBA* gba, int timer);
156void GBATimerWriteTMCNT_LO(struct GBA* gba, int timer, uint16_t value);
157void GBATimerWriteTMCNT_HI(struct GBA* gba, int timer, uint16_t value);
158
159void GBAWriteIE(struct GBA* gba, uint16_t value);
160void GBAWriteIME(struct GBA* gba, uint16_t value);
161void GBARaiseIRQ(struct GBA* gba, enum GBAIRQ irq);
162void GBATestIRQ(struct ARMCore* cpu);
163void GBAHalt(struct GBA* gba);
164
165void GBAAttachDebugger(struct GBA* gba, struct ARMDebugger* debugger);
166void GBADetachDebugger(struct GBA* gba);
167
168void GBALoadROM(struct GBA* gba, struct VFile* vf, struct VFile* sav, const char* fname);
169void GBALoadBIOS(struct GBA* gba, struct VFile* vf);
170void GBAApplyPatch(struct GBA* gba, struct Patch* patch);
171
172bool GBAIsROM(struct VFile* vf);
173bool GBAIsBIOS(struct VFile* vf);
174void GBAGetGameCode(struct GBA* gba, char* out);
175void GBAGetGameTitle(struct GBA* gba, char* out);
176
177__attribute__((format (printf, 3, 4)))
178void GBALog(struct GBA* gba, enum GBALogLevel level, const char* format, ...);
179
180__attribute__((format (printf, 3, 4)))
181void GBADebuggerLogShim(struct ARMDebugger* debugger, enum DebuggerLogLevel level, const char* format, ...);
182
183#endif