1/* Copyright (c) 2013-2016 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 M_CORE_H
  7#define M_CORE_H
  8
  9#include <mgba-util/common.h>
 10
 11CXX_GUARD_START
 12
 13#include <mgba/core/config.h>
 14#if !defined(MINIMAL_CORE) || MINIMAL_CORE < 2
 15#include <mgba/core/directories.h>
 16#endif
 17#ifndef MINIMAL_CORE
 18#include <mgba/core/input.h>
 19#endif
 20#include <mgba/core/interface.h>
 21#ifdef USE_DEBUGGERS
 22// TODO: Fix layering violation
 23#include <mgba/internal/debugger/debugger.h>
 24#endif
 25
 26enum mPlatform {
 27	PLATFORM_NONE = -1,
 28#ifdef M_CORE_GBA
 29	PLATFORM_GBA,
 30#endif
 31#ifdef M_CORE_GB
 32	PLATFORM_GB,
 33#endif
 34};
 35
 36enum mCoreChecksumType {
 37	CHECKSUM_CRC32,
 38};
 39
 40struct mRTCSource;
 41struct mCoreConfig;
 42struct mCoreSync;
 43struct mStateExtdata;
 44struct mCore {
 45	void* cpu;
 46	void* board;
 47	struct mDebugger* debugger;
 48
 49#if !defined(MINIMAL_CORE) || MINIMAL_CORE < 2
 50	struct mDirectorySet dirs;
 51#endif
 52#ifndef MINIMAL_CORE
 53	struct mInputMap inputMap;
 54#endif
 55	struct mCoreConfig config;
 56	struct mCoreOptions opts;
 57
 58	bool (*init)(struct mCore*);
 59	void (*deinit)(struct mCore*);
 60
 61	enum mPlatform (*platform)(const struct mCore*);
 62
 63	void (*setSync)(struct mCore*, struct mCoreSync*);
 64	void (*loadConfig)(struct mCore*, const struct mCoreConfig*);
 65
 66	void (*desiredVideoDimensions)(struct mCore*, unsigned* width, unsigned* height);
 67	void (*setVideoBuffer)(struct mCore*, color_t* buffer, size_t stride);
 68
 69	void (*getPixels)(struct mCore*, const void** buffer, size_t* stride);
 70	void (*putPixels)(struct mCore*, const void* buffer, size_t stride);
 71
 72	struct blip_t* (*getAudioChannel)(struct mCore*, int ch);
 73	void (*setAudioBufferSize)(struct mCore*, size_t samples);
 74	size_t (*getAudioBufferSize)(struct mCore*);
 75
 76	void (*setCoreCallbacks)(struct mCore*, struct mCoreCallbacks*);
 77	void (*setAVStream)(struct mCore*, struct mAVStream*);
 78
 79	bool (*isROM)(struct VFile* vf);
 80	bool (*loadROM)(struct mCore*, struct VFile* vf);
 81	bool (*loadSave)(struct mCore*, struct VFile* vf);
 82	bool (*loadTemporarySave)(struct mCore*, struct VFile* vf);
 83	void (*unloadROM)(struct mCore*);
 84	void (*checksum)(const struct mCore*, void* data, enum mCoreChecksumType type);
 85
 86	bool (*loadBIOS)(struct mCore*, struct VFile* vf, int biosID);
 87	bool (*selectBIOS)(struct mCore*, int biosID);
 88
 89	bool (*loadPatch)(struct mCore*, struct VFile* vf);
 90
 91	void (*reset)(struct mCore*);
 92	void (*runFrame)(struct mCore*);
 93	void (*runLoop)(struct mCore*);
 94	void (*step)(struct mCore*);
 95
 96	size_t (*stateSize)(struct mCore*);
 97	bool (*loadState)(struct mCore*, const void* state);
 98	bool (*saveState)(struct mCore*, void* state);
 99
100	void (*setKeys)(struct mCore*, uint32_t keys);
101	void (*addKeys)(struct mCore*, uint32_t keys);
102	void (*clearKeys)(struct mCore*, uint32_t keys);
103
104	int32_t (*frameCounter)(const struct mCore*);
105	int32_t (*frameCycles)(const struct mCore*);
106	int32_t (*frequency)(const struct mCore*);
107
108	void (*getGameTitle)(const struct mCore*, char* title);
109	void (*getGameCode)(const struct mCore*, char* title);
110
111	void (*setRTC)(struct mCore*, struct mRTCSource*);
112	void (*setRotation)(struct mCore*, struct mRotationSource*);
113	void (*setRumble)(struct mCore*, struct mRumble*);
114
115	uint32_t (*busRead8)(struct mCore*, uint32_t address);
116	uint32_t (*busRead16)(struct mCore*, uint32_t address);
117	uint32_t (*busRead32)(struct mCore*, uint32_t address);
118
119	void (*busWrite8)(struct mCore*, uint32_t address, uint8_t);
120	void (*busWrite16)(struct mCore*, uint32_t address, uint16_t);
121	void (*busWrite32)(struct mCore*, uint32_t address, uint32_t);
122
123	uint32_t (*rawRead8)(struct mCore*, uint32_t address, int segment);
124	uint32_t (*rawRead16)(struct mCore*, uint32_t address, int segment);
125	uint32_t (*rawRead32)(struct mCore*, uint32_t address, int segment);
126
127	void (*rawWrite8)(struct mCore*, uint32_t address, int segment, uint8_t);
128	void (*rawWrite16)(struct mCore*, uint32_t address, int segment, uint16_t);
129	void (*rawWrite32)(struct mCore*, uint32_t address, int segment, uint32_t);
130
131#ifdef USE_DEBUGGERS
132	bool (*supportsDebuggerType)(struct mCore*, enum mDebuggerType);
133	struct mDebuggerPlatform* (*debuggerPlatform)(struct mCore*);
134	struct CLIDebuggerSystem* (*cliDebuggerSystem)(struct mCore*);
135	void (*attachDebugger)(struct mCore*, struct mDebugger*);
136	void (*detachDebugger)(struct mCore*);
137#endif
138
139	struct mCheatDevice* (*cheatDevice)(struct mCore*);
140
141	size_t (*savedataClone)(struct mCore*, void** sram);
142	bool (*savedataRestore)(struct mCore*, const void* sram, size_t size, bool writeback);
143};
144
145#if !defined(MINIMAL_CORE) || MINIMAL_CORE < 2
146struct mCore* mCoreFind(const char* path);
147bool mCoreLoadFile(struct mCore* core, const char* path);
148
149bool mCoreAutoloadSave(struct mCore* core);
150bool mCoreAutoloadPatch(struct mCore* core);
151
152bool mCoreSaveState(struct mCore* core, int slot, int flags);
153bool mCoreLoadState(struct mCore* core, int slot, int flags);
154struct VFile* mCoreGetState(struct mCore* core, int slot, bool write);
155void mCoreDeleteState(struct mCore* core, int slot);
156
157void mCoreTakeScreenshot(struct mCore* core);
158#endif
159
160struct mCore* mCoreFindVF(struct VFile* vf);
161enum mPlatform mCoreIsCompatible(struct VFile* vf);
162
163bool mCoreSaveStateNamed(struct mCore* core, struct VFile* vf, int flags);
164bool mCoreLoadStateNamed(struct mCore* core, struct VFile* vf, int flags);
165
166void mCoreInitConfig(struct mCore* core, const char* port);
167void mCoreLoadConfig(struct mCore* core);
168void mCoreLoadForeignConfig(struct mCore* core, const struct mCoreConfig* config);
169
170CXX_GUARD_END
171
172#endif