mirror of https://github.com/bsnes-emu/bsnes.git
633 lines
21 KiB
C
633 lines
21 KiB
C
#ifndef GB_h
|
||
#define GB_h
|
||
#include <stdbool.h>
|
||
#include <stdint.h>
|
||
#include <time.h>
|
||
|
||
#include "gb_struct_def.h"
|
||
#include "save_state.h"
|
||
|
||
#include "apu.h"
|
||
#include "camera.h"
|
||
#include "debugger.h"
|
||
#include "display.h"
|
||
#include "joypad.h"
|
||
#include "mbc.h"
|
||
#include "memory.h"
|
||
#include "printer.h"
|
||
#include "timing.h"
|
||
#include "rewind.h"
|
||
#include "z80_cpu.h"
|
||
#include "symbol_hash.h"
|
||
|
||
#define GB_STRUCT_VERSION 12
|
||
|
||
enum {
|
||
GB_REGISTER_AF,
|
||
GB_REGISTER_BC,
|
||
GB_REGISTER_DE,
|
||
GB_REGISTER_HL,
|
||
GB_REGISTER_SP,
|
||
GB_REGISTERS_16_BIT /* Count */
|
||
};
|
||
|
||
/* Todo: Actually use these! */
|
||
enum {
|
||
GB_CARRY_FLAG = 16,
|
||
GB_HALF_CARRY_FLAG = 32,
|
||
GB_SUBSTRACT_FLAG = 64,
|
||
GB_ZERO_FLAG = 128,
|
||
};
|
||
|
||
#define GB_MAX_IR_QUEUE 256
|
||
|
||
enum {
|
||
/* Joypad and Serial */
|
||
GB_IO_JOYP = 0x00, // Joypad (R/W)
|
||
GB_IO_SB = 0x01, // Serial transfer data (R/W)
|
||
GB_IO_SC = 0x02, // Serial Transfer Control (R/W)
|
||
|
||
/* Missing */
|
||
|
||
/* Timers */
|
||
GB_IO_DIV = 0x04, // Divider Register (R/W)
|
||
GB_IO_TIMA = 0x05, // Timer counter (R/W)
|
||
GB_IO_TMA = 0x06, // Timer Modulo (R/W)
|
||
GB_IO_TAC = 0x07, // Timer Control (R/W)
|
||
|
||
/* Missing */
|
||
|
||
GB_IO_IF = 0x0f, // Interrupt Flag (R/W)
|
||
|
||
/* Sound */
|
||
GB_IO_NR10 = 0x10, // Channel 1 Sweep register (R/W)
|
||
GB_IO_NR11 = 0x11, // Channel 1 Sound length/Wave pattern duty (R/W)
|
||
GB_IO_NR12 = 0x12, // Channel 1 Volume Envelope (R/W)
|
||
GB_IO_NR13 = 0x13, // Channel 1 Frequency lo (Write Only)
|
||
GB_IO_NR14 = 0x14, // Channel 1 Frequency hi (R/W)
|
||
/* NR20 does not exist */
|
||
GB_IO_NR21 = 0x16, // Channel 2 Sound Length/Wave Pattern Duty (R/W)
|
||
GB_IO_NR22 = 0x17, // Channel 2 Volume Envelope (R/W)
|
||
GB_IO_NR23 = 0x18, // Channel 2 Frequency lo data (W)
|
||
GB_IO_NR24 = 0x19, // Channel 2 Frequency hi data (R/W)
|
||
GB_IO_NR30 = 0x1a, // Channel 3 Sound on/off (R/W)
|
||
GB_IO_NR31 = 0x1b, // Channel 3 Sound Length
|
||
GB_IO_NR32 = 0x1c, // Channel 3 Select output level (R/W)
|
||
GB_IO_NR33 = 0x1d, // Channel 3 Frequency's lower data (W)
|
||
GB_IO_NR34 = 0x1e, // Channel 3 Frequency's higher data (R/W)
|
||
/* NR40 does not exist */
|
||
GB_IO_NR41 = 0x20, // Channel 4 Sound Length (R/W)
|
||
GB_IO_NR42 = 0x21, // Channel 4 Volume Envelope (R/W)
|
||
GB_IO_NR43 = 0x22, // Channel 4 Polynomial Counter (R/W)
|
||
GB_IO_NR44 = 0x23, // Channel 4 Counter/consecutive, Inital (R/W)
|
||
GB_IO_NR50 = 0x24, // Channel control / ON-OFF / Volume (R/W)
|
||
GB_IO_NR51 = 0x25, // Selection of Sound output terminal (R/W)
|
||
GB_IO_NR52 = 0x26, // Sound on/off
|
||
|
||
/* Missing */
|
||
|
||
GB_IO_WAV_START = 0x30, // Wave pattern start
|
||
GB_IO_WAV_END = 0x3f, // Wave pattern end
|
||
|
||
/* Graphics */
|
||
GB_IO_LCDC = 0x40, // LCD Control (R/W)
|
||
GB_IO_STAT = 0x41, // LCDC Status (R/W)
|
||
GB_IO_SCY = 0x42, // Scroll Y (R/W)
|
||
GB_IO_SCX = 0x43, // Scroll X (R/W)
|
||
GB_IO_LY = 0x44, // LCDC Y-Coordinate (R)
|
||
GB_IO_LYC = 0x45, // LY Compare (R/W)
|
||
GB_IO_DMA = 0x46, // DMA Transfer and Start Address (W)
|
||
GB_IO_BGP = 0x47, // BG Palette Data (R/W) - Non CGB Mode Only
|
||
GB_IO_OBP0 = 0x48, // Object Palette 0 Data (R/W) - Non CGB Mode Only
|
||
GB_IO_OBP1 = 0x49, // Object Palette 1 Data (R/W) - Non CGB Mode Only
|
||
GB_IO_WY = 0x4a, // Window Y Position (R/W)
|
||
GB_IO_WX = 0x4b, // Window X Position minus 7 (R/W)
|
||
// Has some undocumented compatibility flags written at boot.
|
||
// Unfortunately it is not readable or writable after boot has finished, so research of this
|
||
// register is quite limited. The value written to this register, however, can be controlled
|
||
// in some cases.
|
||
GB_IO_DMG_EMULATION = 0x4c,
|
||
|
||
/* General CGB features */
|
||
GB_IO_KEY1 = 0x4d, // CGB Mode Only - Prepare Speed Switch
|
||
|
||
/* Missing */
|
||
|
||
GB_IO_VBK = 0x4f, // CGB Mode Only - VRAM Bank
|
||
GB_IO_BIOS = 0x50, // Write to disable the BIOS mapping
|
||
|
||
/* CGB DMA */
|
||
GB_IO_HDMA1 = 0x51, // CGB Mode Only - New DMA Source, High
|
||
GB_IO_HDMA2 = 0x52, // CGB Mode Only - New DMA Source, Low
|
||
GB_IO_HDMA3 = 0x53, // CGB Mode Only - New DMA Destination, High
|
||
GB_IO_HDMA4 = 0x54, // CGB Mode Only - New DMA Destination, Low
|
||
GB_IO_HDMA5 = 0x55, // CGB Mode Only - New DMA Length/Mode/Start
|
||
|
||
/* IR */
|
||
GB_IO_RP = 0x56, // CGB Mode Only - Infrared Communications Port
|
||
|
||
/* Missing */
|
||
|
||
/* CGB Paletts */
|
||
GB_IO_BGPI = 0x68, // CGB Mode Only - Background Palette Index
|
||
GB_IO_BGPD = 0x69, // CGB Mode Only - Background Palette Data
|
||
GB_IO_OBPI = 0x6a, // CGB Mode Only - Sprite Palette Index
|
||
GB_IO_OBPD = 0x6b, // CGB Mode Only - Sprite Palette Data
|
||
|
||
// 1 is written for DMG ROMs on a CGB. Does not appear to have an effect.
|
||
GB_IO_DMG_EMULATION_INDICATION = 0x6c, // (FEh) Bit 0 (Read/Write)
|
||
|
||
/* Missing */
|
||
|
||
GB_IO_SVBK = 0x70, // CGB Mode Only - WRAM Bank
|
||
GB_IO_UNKNOWN2 = 0x72, // (00h) - Bit 0-7 (Read/Write)
|
||
GB_IO_UNKNOWN3 = 0x73, // (00h) - Bit 0-7 (Read/Write)
|
||
GB_IO_UNKNOWN4 = 0x74, // (00h) - Bit 0-7 (Read/Write) - CGB Mode Only
|
||
GB_IO_UNKNOWN5 = 0x75, // (8Fh) - Bit 4-6 (Read/Write)
|
||
GB_IO_PCM_12 = 0x76, // Channels 1 and 2 amplitudes
|
||
GB_IO_PCM_34 = 0x77, // Channels 3 and 4 amplitudes
|
||
GB_IO_UNKNOWN8 = 0x7F, // Unknown, write only
|
||
};
|
||
|
||
typedef enum {
|
||
GB_LOG_BOLD = 1,
|
||
GB_LOG_DASHED_UNDERLINE = 2,
|
||
GB_LOG_UNDERLINE = 4,
|
||
GB_LOG_UNDERLINE_MASK = GB_LOG_DASHED_UNDERLINE | GB_LOG_UNDERLINE
|
||
} GB_log_attributes;
|
||
|
||
#ifdef GB_INTERNAL
|
||
#define LCDC_PERIOD 70224
|
||
#define CPU_FREQUENCY 0x400000
|
||
#define DIV_CYCLES (0x100)
|
||
#define INTERNAL_DIV_CYCLES (0x40000)
|
||
|
||
#if !defined(MIN)
|
||
#define MIN(A,B) ({ __typeof__(A) __a = (A); __typeof__(B) __b = (B); __a < __b ? __a : __b; })
|
||
#endif
|
||
|
||
#if !defined(MAX)
|
||
#define MAX(A,B) ({ __typeof__(A) __a = (A); __typeof__(B) __b = (B); __a < __b ? __b : __a; })
|
||
#endif
|
||
#endif
|
||
|
||
typedef void (*GB_vblank_callback_t)(GB_gameboy_t *gb);
|
||
typedef void (*GB_log_callback_t)(GB_gameboy_t *gb, const char *string, GB_log_attributes attributes);
|
||
typedef char *(*GB_input_callback_t)(GB_gameboy_t *gb);
|
||
typedef uint32_t (*GB_rgb_encode_callback_t)(GB_gameboy_t *gb, uint8_t r, uint8_t g, uint8_t b);
|
||
typedef void (*GB_infrared_callback_t)(GB_gameboy_t *gb, bool on, long cycles_since_last_update);
|
||
typedef void (*GB_rumble_callback_t)(GB_gameboy_t *gb, bool rumble_on);
|
||
typedef void (*GB_serial_transfer_start_callback_t)(GB_gameboy_t *gb, uint8_t byte_to_send);
|
||
typedef uint8_t (*GB_serial_transfer_end_callback_t)(GB_gameboy_t *gb);
|
||
|
||
typedef struct {
|
||
bool state;
|
||
long delay;
|
||
} GB_ir_queue_item_t;
|
||
|
||
struct GB_breakpoint_s;
|
||
struct GB_watchpoint_s;
|
||
|
||
typedef struct {
|
||
uint8_t pixel; // Color, 0-3
|
||
uint8_t palette; // Palette, 0 - 7 (CGB); 0-1 in DMG (or just 0 for BG)
|
||
uint8_t priority; // Sprite priority – 0 in DMG, OAM index in CGB
|
||
bool bg_priority; // For sprite FIFO – the BG priority bit. For the BG FIFO – the CGB attributes priority bit
|
||
} GB_fifo_item_t;
|
||
|
||
typedef struct {
|
||
GB_fifo_item_t fifo[16];
|
||
uint8_t read_end;
|
||
uint8_t write_end;
|
||
} GB_fifo_t;
|
||
|
||
/* When state saving, each section is dumped independently of other sections.
|
||
This allows adding data to the end of the section without worrying about future compatibility.
|
||
Some other changes might be "safe" as well.
|
||
This struct is not packed, but dumped sections exclusively use types that have the same alignment in both 32 and 64
|
||
bit platforms. */
|
||
|
||
/* We make sure bool is 1 for cross-platform save state compatibility. */
|
||
/* Todo: We might want to typedef our own bool if this prevents SameBoy from working on specific platforms. */
|
||
_Static_assert(sizeof(bool) == 1, "sizeof(bool) != 1");
|
||
|
||
#ifdef GB_INTERNAL
|
||
struct GB_gameboy_s {
|
||
#else
|
||
struct GB_gameboy_internal_s {
|
||
#endif
|
||
GB_SECTION(header,
|
||
/* The magic makes sure a state file is:
|
||
- Indeed a SameBoy state file.
|
||
- Has the same endianess has the current platform. */
|
||
volatile uint32_t magic;
|
||
/* The version field makes sure we don't load save state files with a completely different structure.
|
||
This happens when struct fields are removed/resized in an backward incompatible manner. */
|
||
uint32_t version;
|
||
);
|
||
|
||
GB_SECTION(core_state,
|
||
/* Registers */
|
||
uint16_t pc;
|
||
union {
|
||
uint16_t registers[GB_REGISTERS_16_BIT];
|
||
struct {
|
||
uint16_t af,
|
||
bc,
|
||
de,
|
||
hl,
|
||
sp;
|
||
};
|
||
struct {
|
||
#if __BYTE_ORDER__ == __ORDER_BIG_ENDIAN__
|
||
uint8_t a, f,
|
||
b, c,
|
||
d, e,
|
||
h, l;
|
||
#elif __BYTE_ORDER__ == __ORDER_LITTLE_ENDIAN__
|
||
uint8_t f, a,
|
||
c, b,
|
||
e, d,
|
||
l, h;
|
||
#else
|
||
#error Unable to detect endianess
|
||
#endif
|
||
};
|
||
|
||
};
|
||
uint8_t ime;
|
||
uint8_t interrupt_enable;
|
||
uint8_t cgb_ram_bank;
|
||
|
||
/* CPU and General Hardware Flags*/
|
||
bool cgb_mode;
|
||
bool is_cgb;
|
||
bool cgb_double_speed;
|
||
bool halted;
|
||
bool stopped;
|
||
bool boot_rom_finished;
|
||
bool ime_toggle; /* ei has delayed a effect.*/
|
||
bool halt_bug;
|
||
|
||
/* Misc state */
|
||
bool infrared_input;
|
||
GB_printer_t printer;
|
||
);
|
||
|
||
/* DMA and HDMA */
|
||
GB_SECTION(dma,
|
||
bool hdma_on;
|
||
bool hdma_on_hblank;
|
||
uint8_t hdma_steps_left;
|
||
uint16_t hdma_cycles; // in 8MHz units
|
||
uint16_t hdma_current_src, hdma_current_dest;
|
||
|
||
uint8_t dma_steps_left;
|
||
uint8_t dma_current_dest;
|
||
uint16_t dma_current_src;
|
||
int16_t dma_cycles;
|
||
bool is_dma_restarting;
|
||
uint8_t last_opcode_read; /* Required to emulte HDMA reads from Exxx */
|
||
bool hdma_starting;
|
||
);
|
||
|
||
/* MBC */
|
||
GB_SECTION(mbc,
|
||
uint16_t mbc_rom_bank;
|
||
uint8_t mbc_ram_bank;
|
||
uint32_t mbc_ram_size;
|
||
bool mbc_ram_enable;
|
||
union {
|
||
struct {
|
||
uint8_t bank_low:5;
|
||
uint8_t bank_high:2;
|
||
uint8_t mode:1;
|
||
} mbc1;
|
||
|
||
struct {
|
||
uint8_t rom_bank:4;
|
||
} mbc2;
|
||
|
||
struct {
|
||
uint8_t rom_bank:7;
|
||
uint8_t padding:1;
|
||
uint8_t ram_bank:4;
|
||
} mbc3;
|
||
|
||
struct {
|
||
uint8_t rom_bank_low;
|
||
uint8_t rom_bank_high:1;
|
||
uint8_t ram_bank:4;
|
||
} mbc5;
|
||
|
||
struct {
|
||
uint8_t bank_low:6;
|
||
uint8_t bank_high:3;
|
||
uint8_t mode:1;
|
||
} huc1;
|
||
|
||
struct {
|
||
uint8_t rom_bank;
|
||
uint8_t ram_bank;
|
||
} huc3;
|
||
};
|
||
uint16_t mbc_rom0_bank; /* For some MBC1 wirings. */
|
||
bool camera_registers_mapped;
|
||
uint8_t camera_registers[0x36];
|
||
bool rumble_state;
|
||
);
|
||
|
||
|
||
/* HRAM and HW Registers */
|
||
GB_SECTION(hram,
|
||
uint8_t hram[0xFFFF - 0xFF80];
|
||
uint8_t io_registers[0x80];
|
||
);
|
||
|
||
/* Timing */
|
||
GB_SECTION(timing,
|
||
GB_UNIT(display);
|
||
GB_UNIT(div);
|
||
uint32_t div_counter;
|
||
uint8_t tima_reload_state; /* After TIMA overflows, it becomes 0 for 4 cycles before actually reloading. */
|
||
uint16_t serial_cycles;
|
||
uint16_t serial_length;
|
||
);
|
||
|
||
/* APU */
|
||
GB_SECTION(apu,
|
||
GB_apu_t apu;
|
||
);
|
||
|
||
/* RTC */
|
||
GB_SECTION(rtc,
|
||
union {
|
||
struct {
|
||
uint8_t seconds;
|
||
uint8_t minutes;
|
||
uint8_t hours;
|
||
uint8_t days;
|
||
uint8_t high;
|
||
};
|
||
uint8_t data[5];
|
||
} rtc_real, rtc_latched;
|
||
time_t last_rtc_second;
|
||
bool rtc_latch;
|
||
);
|
||
|
||
/* Video Display */
|
||
GB_SECTION(video,
|
||
uint32_t vram_size; // Different between CGB and DMG
|
||
uint8_t cgb_vram_bank;
|
||
uint8_t oam[0xA0];
|
||
uint8_t background_palettes_data[0x40];
|
||
uint8_t sprite_palettes_data[0x40];
|
||
uint8_t position_in_line;
|
||
bool stat_interrupt_line;
|
||
uint8_t effective_scx;
|
||
uint8_t wy_diff;
|
||
/* The LCDC will skip the first frame it renders after turning it on.
|
||
On the CGB, a frame is not skipped if the previous frame was skipped as well.
|
||
See https://www.reddit.com/r/EmuDev/comments/6exyxu/ */
|
||
enum {
|
||
GB_FRAMESKIP_LCD_TURNED_ON, // On a DMG, the LCD renders a blank screen during this state,
|
||
// on a CGB, the previous frame is repeated (which might be
|
||
// blank if the LCD was off for more than a few cycles)
|
||
GB_FRAMESKIP_FIRST_FRAME_SKIPPED, // This state is 'skipped' when emulating a DMG
|
||
GB_FRAMESKIP_SECOND_FRAME_RENDERED,
|
||
} frame_skip_state;
|
||
bool oam_read_blocked;
|
||
bool vram_read_blocked;
|
||
bool oam_write_blocked;
|
||
bool vram_write_blocked;
|
||
bool window_disabled_while_active;
|
||
uint8_t current_line;
|
||
uint16_t ly_for_comparison;
|
||
GB_fifo_t bg_fifo, oam_fifo;
|
||
uint8_t fetcher_x;
|
||
uint8_t fetcher_y;
|
||
uint16_t cycles_for_line;
|
||
uint8_t current_tile;
|
||
uint8_t current_tile_attributes;
|
||
uint16_t current_tile_address;
|
||
uint8_t current_tile_data[2];
|
||
enum {
|
||
GB_FETCHER_GET_TILE,
|
||
GB_FETCHER_GET_TILE_DATA_LOWER,
|
||
GB_FETCHER_GET_TILE_DATA_HIGH,
|
||
GB_FETCHER_SLEEP,
|
||
GB_FETCHER_MAX = GB_FETCHER_SLEEP,
|
||
} fetcher_state:8;
|
||
bool fetcher_divisor; // The fetcher runs at 2MHz
|
||
bool bg_fifo_paused;
|
||
bool oam_fifo_paused;
|
||
bool in_window;
|
||
uint8_t visible_objs[10];
|
||
uint8_t obj_comperators[10];
|
||
uint8_t n_visible_objs;
|
||
uint8_t fetcher_stop_penalty;
|
||
uint8_t oam_search_index;
|
||
uint8_t accessed_oam_row;
|
||
uint8_t extra_penalty_for_sprite_at_0;
|
||
bool is_first_line_mode2;
|
||
bool oam_interrupt_line;
|
||
);
|
||
|
||
/* Unsaved data. This includes all pointers, as well as everything that shouldn't be on a save state */
|
||
/* This data is reserved on reset and must come last in the struct */
|
||
GB_SECTION(unsaved,
|
||
/* ROM */
|
||
uint8_t *rom;
|
||
uint32_t rom_size;
|
||
const GB_cartridge_t *cartridge_type;
|
||
enum {
|
||
GB_STANDARD_MBC1_WIRING,
|
||
GB_MBC1M_WIRING,
|
||
} mbc1_wiring;
|
||
|
||
/* Various RAMs */
|
||
uint8_t *ram;
|
||
uint8_t *vram;
|
||
uint8_t *mbc_ram;
|
||
|
||
/* I/O */
|
||
uint32_t *screen;
|
||
uint32_t background_palettes_rgb[0x20];
|
||
uint32_t sprite_palettes_rgb[0x20];
|
||
GB_color_correction_mode_t color_correction_mode;
|
||
bool keys[GB_KEY_MAX];
|
||
|
||
/* Timing */
|
||
uint64_t last_sync;
|
||
uint64_t cycles_since_last_sync; // In 8MHz units
|
||
|
||
/* Audio */
|
||
GB_apu_output_t apu_output;
|
||
|
||
/* Callbacks */
|
||
void *user_data;
|
||
GB_log_callback_t log_callback;
|
||
GB_input_callback_t input_callback;
|
||
GB_input_callback_t async_input_callback;
|
||
GB_rgb_encode_callback_t rgb_encode_callback;
|
||
GB_vblank_callback_t vblank_callback;
|
||
GB_infrared_callback_t infrared_callback;
|
||
GB_camera_get_pixel_callback_t camera_get_pixel_callback;
|
||
GB_camera_update_request_callback_t camera_update_request_callback;
|
||
GB_rumble_callback_t rumble_callback;
|
||
GB_serial_transfer_start_callback_t serial_transfer_start_callback;
|
||
GB_serial_transfer_end_callback_t serial_transfer_end_callback;
|
||
|
||
/* IR */
|
||
long cycles_since_ir_change; // In 8MHz units
|
||
long cycles_since_input_ir_change; // In 8MHz units
|
||
GB_ir_queue_item_t ir_queue[GB_MAX_IR_QUEUE];
|
||
size_t ir_queue_length;
|
||
|
||
/*** Debugger ***/
|
||
volatile bool debug_stopped, debug_disable;
|
||
bool debug_fin_command, debug_next_command;
|
||
|
||
/* Breakpoints */
|
||
uint16_t n_breakpoints;
|
||
struct GB_breakpoint_s *breakpoints;
|
||
|
||
/* SLD (Todo: merge with backtrace) */
|
||
bool stack_leak_detection;
|
||
int debug_call_depth;
|
||
uint16_t sp_for_call_depth[0x200]; /* Should be much more than enough */
|
||
uint16_t addr_for_call_depth[0x200];
|
||
|
||
/* Backtrace */
|
||
unsigned int backtrace_size;
|
||
uint16_t backtrace_sps[0x200];
|
||
struct {
|
||
uint16_t bank;
|
||
uint16_t addr;
|
||
} backtrace_returns[0x200];
|
||
|
||
/* Watchpoints */
|
||
uint16_t n_watchpoints;
|
||
struct GB_watchpoint_s *watchpoints;
|
||
|
||
/* Symbol tables */
|
||
GB_symbol_map_t *bank_symbols[0x200];
|
||
GB_reversed_symbol_map_t reversed_symbol_map;
|
||
|
||
/* Ticks command */
|
||
unsigned long debugger_ticks;
|
||
|
||
/* Rewind */
|
||
#define GB_REWIND_FRAMES_PER_KEY 255
|
||
size_t rewind_buffer_length;
|
||
struct {
|
||
uint8_t *key_state;
|
||
uint8_t *compressed_states[GB_REWIND_FRAMES_PER_KEY];
|
||
unsigned pos;
|
||
} *rewind_sequences; // lasts about 4 seconds
|
||
size_t rewind_pos;
|
||
|
||
/* Misc */
|
||
bool turbo;
|
||
bool turbo_dont_skip;
|
||
bool disable_rendering;
|
||
uint32_t ram_size; // Different between CGB and DMG
|
||
uint8_t boot_rom[0x900];
|
||
bool vblank_just_occured; // For slow operations involving syscalls; these should only run once per vblank
|
||
uint8_t cycles_since_run; // How many cycles have passed since the last call to GB_run(), in 8MHz units
|
||
double clock_multiplier;
|
||
);
|
||
};
|
||
|
||
#ifndef GB_INTERNAL
|
||
struct GB_gameboy_s {
|
||
char __internal[sizeof(struct GB_gameboy_internal_s)];
|
||
};
|
||
#endif
|
||
|
||
|
||
#ifndef __printflike
|
||
/* Missing from Linux headers. */
|
||
#define __printflike(fmtarg, firstvararg) \
|
||
__attribute__((__format__ (__printf__, fmtarg, firstvararg)))
|
||
#endif
|
||
|
||
void GB_init(GB_gameboy_t *gb);
|
||
void GB_init_cgb(GB_gameboy_t *gb);
|
||
bool GB_is_inited(GB_gameboy_t *gb);
|
||
bool GB_is_cgb(GB_gameboy_t *gb);
|
||
void GB_free(GB_gameboy_t *gb);
|
||
void GB_reset(GB_gameboy_t *gb);
|
||
void GB_switch_model_and_reset(GB_gameboy_t *gb, bool is_cgb);
|
||
|
||
/* Returns the time passed, in 4MHz ticks. */
|
||
uint8_t GB_run(GB_gameboy_t *gb);
|
||
/* Returns the time passed since the last frame, in nanoseconds */
|
||
uint64_t GB_run_frame(GB_gameboy_t *gb);
|
||
|
||
typedef enum {
|
||
GB_DIRECT_ACCESS_ROM,
|
||
GB_DIRECT_ACCESS_RAM,
|
||
GB_DIRECT_ACCESS_CART_RAM,
|
||
GB_DIRECT_ACCESS_VRAM,
|
||
GB_DIRECT_ACCESS_HRAM,
|
||
GB_DIRECT_ACCESS_IO, /* Warning: Some registers can only be read/written correctly via GB_memory_read/write. */
|
||
GB_DIRECT_ACCESS_BOOTROM,
|
||
GB_DIRECT_ACCESS_OAM,
|
||
GB_DIRECT_ACCESS_BGP,
|
||
GB_DIRECT_ACCESS_OBP,
|
||
GB_DIRECT_ACCESS_IE,
|
||
} GB_direct_access_t;
|
||
|
||
/* Returns a mutable pointer to various hardware memories. If that memory is banked, the current bank
|
||
is returned at *bank, even if only a portion of the memory is banked. */
|
||
void *GB_get_direct_access(GB_gameboy_t *gb, GB_direct_access_t access, size_t *size, uint16_t *bank);
|
||
|
||
void *GB_get_user_data(GB_gameboy_t *gb);
|
||
void GB_set_user_data(GB_gameboy_t *gb, void *data);
|
||
|
||
|
||
|
||
int GB_load_boot_rom(GB_gameboy_t *gb, const char *path);
|
||
void GB_load_boot_rom_from_buffer(GB_gameboy_t *gb, const unsigned char *buffer, size_t size);
|
||
int GB_load_rom(GB_gameboy_t *gb, const char *path);
|
||
|
||
int GB_save_battery(GB_gameboy_t *gb, const char *path);
|
||
void GB_load_battery(GB_gameboy_t *gb, const char *path);
|
||
|
||
void GB_set_turbo_mode(GB_gameboy_t *gb, bool on, bool no_frame_skip);
|
||
void GB_set_rendering_disabled(GB_gameboy_t *gb, bool disabled);
|
||
|
||
void GB_log(GB_gameboy_t *gb, const char *fmt, ...) __printflike(2, 3);
|
||
void GB_attributed_log(GB_gameboy_t *gb, GB_log_attributes attributes, const char *fmt, ...) __printflike(3, 4);
|
||
|
||
void GB_set_pixels_output(GB_gameboy_t *gb, uint32_t *output);
|
||
|
||
void GB_set_infrared_input(GB_gameboy_t *gb, bool state);
|
||
void GB_queue_infrared_input(GB_gameboy_t *gb, bool state, long cycles_after_previous_change); /* In 8MHz units*/
|
||
|
||
void GB_set_vblank_callback(GB_gameboy_t *gb, GB_vblank_callback_t callback);
|
||
void GB_set_log_callback(GB_gameboy_t *gb, GB_log_callback_t callback);
|
||
void GB_set_input_callback(GB_gameboy_t *gb, GB_input_callback_t callback);
|
||
void GB_set_async_input_callback(GB_gameboy_t *gb, GB_input_callback_t callback);
|
||
void GB_set_rgb_encode_callback(GB_gameboy_t *gb, GB_rgb_encode_callback_t callback);
|
||
void GB_set_infrared_callback(GB_gameboy_t *gb, GB_infrared_callback_t callback);
|
||
void GB_set_rumble_callback(GB_gameboy_t *gb, GB_rumble_callback_t callback);
|
||
|
||
/* These APIs are used when using internal clock */
|
||
void GB_set_serial_transfer_start_callback(GB_gameboy_t *gb, GB_serial_transfer_start_callback_t callback);
|
||
void GB_set_serial_transfer_end_callback(GB_gameboy_t *gb, GB_serial_transfer_end_callback_t callback);
|
||
|
||
/* These APIs are used when using external clock */
|
||
uint8_t GB_serial_get_data(GB_gameboy_t *gb);
|
||
void GB_serial_set_data(GB_gameboy_t *gb, uint8_t data);
|
||
|
||
void GB_disconnect_serial(GB_gameboy_t *gb);
|
||
|
||
#ifdef GB_INTERNAL
|
||
uint32_t GB_get_clock_rate(GB_gameboy_t *gb);
|
||
#endif
|
||
void GB_set_clock_multiplier(GB_gameboy_t *gb, double multiplier);
|
||
|
||
#endif /* GB_h */
|