gameboy_core 0.3.3

core library to be used for Gameboy emulation
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94

use super::cartridge::Cartridge;
use super::mbc::Mbc;

pub struct Mbc5 {
    cartridge: Cartridge,
    selected_rom_bank: usize,
    selected_rom_bank_high: usize,
    selected_eram_bank: usize,
    external_ram_enabled: bool,
    ram_change_callback: Box<dyn FnMut(usize, u8)>,
}

impl Mbc for Mbc5 {
    fn read_byte(&self, index: u16) -> u8 {
        match index {
            0x0000..=0x3FFF => {
                let rom = self.cartridge.get_rom();
                rom[index as usize]
            }
            0x4000..=0x7FFF => {
                let rom = self.cartridge.get_rom();
                let offset = self.selected_rom_bank * 0x4000;
                rom[index as usize - 0x4000 + offset]
            }
            0xA000..=0xBFFF => {
                if self.external_ram_enabled && self.cartridge.get_ram_size() > 0 {
                    let ram = self.cartridge.get_ram();
                    let offset = self.selected_eram_bank * 0x2000;
                    ram[index as usize - 0xA000 + offset]
                } else {
                    0xFF
                }
            }
            _ => panic!("index out of range: {:04X}", index),
        }
    }

    fn write_byte(&mut self, index: u16, value: u8) {
        match index {
            0x0000..=0x1FFF => self.external_ram_enabled = (value & 0x0F) == 0x0A,
            0x2000..=0x2FFF => {
                self.selected_rom_bank = usize::from(value) | (self.selected_rom_bank_high << 8);
                self.selected_rom_bank &= self.cartridge.get_rom_banks() - 1
            }
            0x3000..=0x3FFF => {
                self.selected_rom_bank_high = usize::from(value) & 0x01;
                self.selected_rom_bank =
                    (self.selected_rom_bank & 0xFF) | (self.selected_rom_bank_high << 8);
                self.selected_rom_bank &= self.cartridge.get_rom_banks() - 1
            }
            0x4000..=0x5FFF => {
                self.selected_eram_bank = usize::from(value) & 0x0F;
                self.selected_eram_bank &= self.cartridge.get_ram_banks() - 1;
            }
            0x6000..=0x7FFF => (),
            0xA000..=0xBFFF => {
                if self.external_ram_enabled && self.cartridge.get_ram_size() > 0 {
                    let ram = self.cartridge.get_ram_mut();
                    let offset = self.selected_eram_bank as usize * 0x2000;
                    let address = index as usize - 0xA000 + offset;
                    ram[address] = value;

                    (self.ram_change_callback)(address, value);
                }
            }
            _ => panic!("index out of range: {:04X}", index),
        }
    }

    fn get_cartridge_mut(&mut self) -> &mut Cartridge {
        &mut self.cartridge
    }

    fn get_cartridge(&self) -> &Cartridge {
        &self.cartridge
    }

    fn set_ram_change_callback(&mut self, f: Box<dyn FnMut(usize, u8)>) {
        self.ram_change_callback = f;
    }
}

impl Mbc5 {
    pub fn new(cartridge: Cartridge) -> Mbc5 {
        Mbc5 {
            cartridge,
            selected_rom_bank: 1,
            selected_rom_bank_high: 0,
            selected_eram_bank: 0,
            external_ram_enabled: false,
            ram_change_callback: Box::new(|_, _| {}),
        }
    }
}