baileytownsend.dev / DMG-Playground
Playing around with reading gameboy roms, and maybe emulation
fork atom

Compare changes

Choose any two refs to compare.

options
unified split
Changed files
+12 -241
Cargo.lock
Cargo.toml
README.md
src
cartridge_header.rs
enums.rs
-229
Cargo.lock 
···

       
5

       
 

       
[[package]]


     

       
6

       
 

       
name = "GameBoyPlayground"


     

       
7

       
 

       
version = "0.1.0"


     

       
8

       
-

       
dependencies = [


     

       
9

       
-

       
 "minifb",


     

       
10

       
-

       
]


     

       
11

       
-

       



     

       
12

       
-

       
[[package]]


     

       
13

       
-

       
name = "bitflags"


     

       
14

       
-

       
version = "1.3.2"


     

       
15

       
-

       
source = "registry+https://github.com/rust-lang/crates.io-index"


     

       
16

       
-

       
checksum = "bef38d45163c2f1dde094a7dfd33ccf595c92905c8f8f4fdc18d06fb1037718a"


     

       
17

       
-

       



     

       
18

       
-

       
[[package]]


     

       
19

       
-

       
name = "bitflags"


     

       
20

       
-

       
version = "2.9.1"


     

       
21

       
-

       
source = "registry+https://github.com/rust-lang/crates.io-index"


     

       
22

       
-

       
checksum = "1b8e56985ec62d17e9c1001dc89c88ecd7dc08e47eba5ec7c29c7b5eeecde967"


     

       
23

       
-

       



     

       
24

       
-

       
[[package]]


     

       
25

       
-

       
name = "cc"


     

       
26

       
-

       
version = "1.2.30"


     

       
27

       
-

       
source = "registry+https://github.com/rust-lang/crates.io-index"


     

       
28

       
-

       
checksum = "deec109607ca693028562ed836a5f1c4b8bd77755c4e132fc5ce11b0b6211ae7"


     

       
29

       
-

       
dependencies = [


     

       
30

       
-

       
 "shlex",


     

       
31

       
-

       
]


     

       
32

       
-

       



     

       
33

       
-

       
[[package]]


     

       
34

       
-

       
name = "cfg-if"


     

       
35

       
-

       
version = "1.0.1"


     

       
36

       
-

       
source = "registry+https://github.com/rust-lang/crates.io-index"


     

       
37

       
-

       
checksum = "9555578bc9e57714c812a1f84e4fc5b4d21fcb063490c624de019f7464c91268"


     

       
38

       
-

       



     

       
39

       
-

       
[[package]]


     

       
40

       
-

       
name = "gdi32-sys"


     

       
41

       
-

       
version = "0.1.2"


     

       
42

       
-

       
source = "registry+https://github.com/rust-lang/crates.io-index"


     

       
43

       
-

       
checksum = "8e3eb92c1107527888f86b6ebb0b7f82794777dbf172a932998660a0a2e26c11"


     

       
44

       
-

       
dependencies = [


     

       
45

       
-

       
 "winapi 0.2.8",


     

       
46

       
-

       
 "winapi-build",


     

       
47

       
-

       
]


     

       
48

       
-

       



     

       
49

       
-

       
[[package]]


     

       
50

       
-

       
name = "kernel32-sys"


     

       
51

       
-

       
version = "0.2.2"


     

       
52

       
-

       
source = "registry+https://github.com/rust-lang/crates.io-index"


     

       
53

       
-

       
checksum = "7507624b29483431c0ba2d82aece8ca6cdba9382bff4ddd0f7490560c056098d"


     

       
54

       
-

       
dependencies = [


     

       
55

       
-

       
 "winapi 0.2.8",


     

       
56

       
-

       
 "winapi-build",


     

       
57

       
-

       
]


     

       
58

       
-

       



     

       
59

       
-

       
[[package]]


     

       
60

       
-

       
name = "lazy_static"


     

       
61

       
-

       
version = "0.2.11"


     

       
62

       
-

       
source = "registry+https://github.com/rust-lang/crates.io-index"


     

       
63

       
-

       
checksum = "76f033c7ad61445c5b347c7382dd1237847eb1bce590fe50365dcb33d546be73"


     

       
64

       
-

       



     

       
65

       
-

       
[[package]]


     

       
66

       
-

       
name = "lazy_static"


     

       
67

       
-

       
version = "1.5.0"


     

       
68

       
-

       
source = "registry+https://github.com/rust-lang/crates.io-index"


     

       
69

       
-

       
checksum = "bbd2bcb4c963f2ddae06a2efc7e9f3591312473c50c6685e1f298068316e66fe"


     

       
70

       
-

       



     

       
71

       
-

       
[[package]]


     

       
72

       
-

       
name = "libc"


     

       
73

       
-

       
version = "0.2.174"


     

       
74

       
-

       
source = "registry+https://github.com/rust-lang/crates.io-index"


     

       
75

       
-

       
checksum = "1171693293099992e19cddea4e8b849964e9846f4acee11b3948bcc337be8776"


     

       
76

       
-

       



     

       
77

       
-

       
[[package]]


     

       
78

       
-

       
name = "libredox"


     

       
79

       
-

       
version = "0.1.6"


     

       
80

       
-

       
source = "registry+https://github.com/rust-lang/crates.io-index"


     

       
81

       
-

       
checksum = "4488594b9328dee448adb906d8b126d9b7deb7cf5c22161ee591610bb1be83c0"


     

       
82

       
-

       
dependencies = [


     

       
83

       
-

       
 "bitflags 2.9.1",


     

       
84

       
-

       
 "libc",


     

       
85

       
-

       
 "redox_syscall",


     

       
86

       
-

       
]


     

       
87

       
-

       



     

       
88

       
-

       
[[package]]


     

       
89

       
-

       
name = "minifb"


     

       
90

       
-

       
version = "0.10.7"


     

       
91

       
-

       
source = "registry+https://github.com/rust-lang/crates.io-index"


     

       
92

       
-

       
checksum = "8cebe353532532dd30eaab68ece91e624ccf6f97453f2da84042f5915450a137"


     

       
93

       
-

       
dependencies = [


     

       
94

       
-

       
 "cc",


     

       
95

       
-

       
 "gdi32-sys",


     

       
96

       
-

       
 "kernel32-sys",


     

       
97

       
-

       
 "orbclient",


     

       
98

       
-

       
 "time",


     

       
99

       
-

       
 "user32-sys",


     

       
100

       
-

       
 "winapi 0.2.8",


     

       
101

       
-

       
 "x11-dl",


     

       
102

       
-

       
]


     

       
103

       
-

       



     

       
104

       
-

       
[[package]]


     

       
105

       
-

       
name = "orbclient"


     

       
106

       
-

       
version = "0.3.48"


     

       
107

       
-

       
source = "registry+https://github.com/rust-lang/crates.io-index"


     

       
108

       
-

       
checksum = "ba0b26cec2e24f08ed8bb31519a9333140a6599b867dac464bb150bdb796fd43"


     

       
109

       
-

       
dependencies = [


     

       
110

       
-

       
 "libc",


     

       
111

       
-

       
 "libredox",


     

       
112

       
-

       
 "sdl2",


     

       
113

       
-

       
 "sdl2-sys",


     

       
114

       
-

       
]


     

       
115

       
-

       



     

       
116

       
-

       
[[package]]


     

       
117

       
-

       
name = "pkg-config"


     

       
118

       
-

       
version = "0.3.32"


     

       
119

       
-

       
source = "registry+https://github.com/rust-lang/crates.io-index"


     

       
120

       
-

       
checksum = "7edddbd0b52d732b21ad9a5fab5c704c14cd949e5e9a1ec5929a24fded1b904c"


     

       
121

       
-

       



     

       
122

       
-

       
[[package]]


     

       
123

       
-

       
name = "redox_syscall"


     

       
124

       
-

       
version = "0.5.15"


     

       
125

       
-

       
source = "registry+https://github.com/rust-lang/crates.io-index"


     

       
126

       
-

       
checksum = "7e8af0dde094006011e6a740d4879319439489813bd0bcdc7d821beaeeff48ec"


     

       
127

       
-

       
dependencies = [


     

       
128

       
-

       
 "bitflags 2.9.1",


     

       
129

       
-

       
]


     

       
130

       
-

       



     

       
131

       
-

       
[[package]]


     

       
132

       
-

       
name = "sdl2"


     

       
133

       
-

       
version = "0.35.2"


     

       
134

       
-

       
source = "registry+https://github.com/rust-lang/crates.io-index"


     

       
135

       
-

       
checksum = "f7959277b623f1fb9e04aea73686c3ca52f01b2145f8ea16f4ff30d8b7623b1a"


     

       
136

       
-

       
dependencies = [


     

       
137

       
-

       
 "bitflags 1.3.2",


     

       
138

       
-

       
 "lazy_static 1.5.0",


     

       
139

       
-

       
 "libc",


     

       
140

       
-

       
 "sdl2-sys",


     

       
141

       
-

       
]


     

       
142

       
-

       



     

       
143

       
-

       
[[package]]


     

       
144

       
-

       
name = "sdl2-sys"


     

       
145

       
-

       
version = "0.35.2"


     

       
146

       
-

       
source = "registry+https://github.com/rust-lang/crates.io-index"


     

       
147

       
-

       
checksum = "e3586be2cf6c0a8099a79a12b4084357aa9b3e0b0d7980e3b67aaf7a9d55f9f0"


     

       
148

       
-

       
dependencies = [


     

       
149

       
-

       
 "cfg-if",


     

       
150

       
-

       
 "libc",


     

       
151

       
-

       
 "version-compare",


     

       
152

       
-

       
]


     

       
153

       
-

       



     

       
154

       
-

       
[[package]]


     

       
155

       
-

       
name = "shlex"


     

       
156

       
-

       
version = "1.3.0"


     

       
157

       
-

       
source = "registry+https://github.com/rust-lang/crates.io-index"


     

       
158

       
-

       
checksum = "0fda2ff0d084019ba4d7c6f371c95d8fd75ce3524c3cb8fb653a3023f6323e64"


     

       
159

       
-

       



     

       
160

       
-

       
[[package]]


     

       
161

       
-

       
name = "time"


     

       
162

       
-

       
version = "0.1.45"


     

       
163

       
-

       
source = "registry+https://github.com/rust-lang/crates.io-index"


     

       
164

       
-

       
checksum = "1b797afad3f312d1c66a56d11d0316f916356d11bd158fbc6ca6389ff6bf805a"


     

       
165

       
-

       
dependencies = [


     

       
166

       
-

       
 "libc",


     

       
167

       
-

       
 "wasi",


     

       
168

       
-

       
 "winapi 0.3.9",


     

       
169

       
-

       
]


     

       
170

       
-

       



     

       
171

       
-

       
[[package]]


     

       
172

       
-

       
name = "user32-sys"


     

       
173

       
-

       
version = "0.1.3"


     

       
174

       
-

       
source = "registry+https://github.com/rust-lang/crates.io-index"


     

       
175

       
-

       
checksum = "e6b719983b952c04198829b51653c06af36f0e44c967fcc1a2bb397ceafbf80a"


     

       
176

       
-

       
dependencies = [


     

       
177

       
-

       
 "winapi 0.2.8",


     

       
178

       
-

       
 "winapi-build",


     

       
179

       
-

       
]


     

       
180

       
-

       



     

       
181

       
-

       
[[package]]


     

       
182

       
-

       
name = "version-compare"


     

       
183

       
-

       
version = "0.1.1"


     

       
184

       
-

       
source = "registry+https://github.com/rust-lang/crates.io-index"


     

       
185

       
-

       
checksum = "579a42fc0b8e0c63b76519a339be31bed574929511fa53c1a3acae26eb258f29"


     

       
186

       
-

       



     

       
187

       
-

       
[[package]]


     

       
188

       
-

       
name = "wasi"


     

       
189

       
-

       
version = "0.10.0+wasi-snapshot-preview1"


     

       
190

       
-

       
source = "registry+https://github.com/rust-lang/crates.io-index"


     

       
191

       
-

       
checksum = "1a143597ca7c7793eff794def352d41792a93c481eb1042423ff7ff72ba2c31f"


     

       
192

       
-

       



     

       
193

       
-

       
[[package]]


     

       
194

       
-

       
name = "winapi"


     

       
195

       
-

       
version = "0.2.8"


     

       
196

       
-

       
source = "registry+https://github.com/rust-lang/crates.io-index"


     

       
197

       
-

       
checksum = "167dc9d6949a9b857f3451275e911c3f44255842c1f7a76f33c55103a909087a"


     

       
198

       
-

       



     

       
199

       
-

       
[[package]]


     

       
200

       
-

       
name = "winapi"


     

       
201

       
-

       
version = "0.3.9"


     

       
202

       
-

       
source = "registry+https://github.com/rust-lang/crates.io-index"


     

       
203

       
-

       
checksum = "5c839a674fcd7a98952e593242ea400abe93992746761e38641405d28b00f419"


     

       
204

       
-

       
dependencies = [


     

       
205

       
-

       
 "winapi-i686-pc-windows-gnu",


     

       
206

       
-

       
 "winapi-x86_64-pc-windows-gnu",


     

       
207

       
-

       
]


     

       
208

       
-

       



     

       
209

       
-

       
[[package]]


     

       
210

       
-

       
name = "winapi-build"


     

       
211

       
-

       
version = "0.1.1"


     

       
212

       
-

       
source = "registry+https://github.com/rust-lang/crates.io-index"


     

       
213

       
-

       
checksum = "2d315eee3b34aca4797b2da6b13ed88266e6d612562a0c46390af8299fc699bc"


     

       
214

       
-

       



     

       
215

       
-

       
[[package]]


     

       
216

       
-

       
name = "winapi-i686-pc-windows-gnu"


     

       
217

       
-

       
version = "0.4.0"


     

       
218

       
-

       
source = "registry+https://github.com/rust-lang/crates.io-index"


     

       
219

       
-

       
checksum = "ac3b87c63620426dd9b991e5ce0329eff545bccbbb34f3be09ff6fb6ab51b7b6"


     

       
220

       
-

       



     

       
221

       
-

       
[[package]]


     

       
222

       
-

       
name = "winapi-x86_64-pc-windows-gnu"


     

       
223

       
-

       
version = "0.4.0"


     

       
224

       
-

       
source = "registry+https://github.com/rust-lang/crates.io-index"


     

       
225

       
-

       
checksum = "712e227841d057c1ee1cd2fb22fa7e5a5461ae8e48fa2ca79ec42cfc1931183f"


     

       
226

       
-

       



     

       
227

       
-

       
[[package]]


     

       
228

       
-

       
name = "x11-dl"


     

       
229

       
-

       
version = "2.14.0"


     

       
230

       
-

       
source = "registry+https://github.com/rust-lang/crates.io-index"


     

       
231

       
-

       
checksum = "326c500cdc166fd7c70dd8c8a829cd5c0ce7be5a5d98c25817de2b9bdc67faf8"


     

       
232

       
-

       
dependencies = [


     

       
233

       
-

       
 "lazy_static 0.2.11",


     

       
234

       
-

       
 "libc",


     

       
235

       
-

       
 "pkg-config",


     

       
236

       
-

       
]


     
···

       
5

       
 

       
[[package]]


     

       
6

       
 

       
name = "GameBoyPlayground"


     

       
7

       
 

       
version = "0.1.0"
-1
Cargo.toml 
···

       
4

       
 

       
edition = "2024"


     

       
5

       
 

       



     

       
6

       
 

       
[dependencies]


     

       
7

       
-

       
minifb = "0.10.7"

     
···

       
4

       
 

       
edition = "2024"


     

       
5

       
 

       



     

       
6

       
 

       
[dependencies]
+3 -9
src/cartridge_header.rs 
···

       
5

       
 

       



     

       
6

       
 

       
pub struct CartridgeHeader {


     

       
7

       
 

       
    //Should be 80 bytes (0x014F(335) - 0x0100(256)) + 1 to include the last address


     

       
8

       
-

       
    pub buffer: [u8; 80],


     

       
9

       
 

       
    pub title: [char; 16],


     

       
10

       
 

       
    pub manufacturer_code: [char; 4],


     

       
11

       
 

       
    pub cgb_flag: CGBFlag,


     
···

       
49

       
 

       
        for (i, true_logo_byte) in NINTENDO_LOGO.iter().enumerate() {


     

       
50

       
 

       
            let rom_byte = nintendo_logo_from_rom[i];


     

       
51

       
 

       
            if rom_byte != *true_logo_byte {


     

       
52

       
-

       
                return Err(Error::CartridgeReadError);


     

       
53

       
 

       
            }


     

       
54

       
 

       
        }


     

       
55

       
 

       



     
···

       
97

       
 

       
        ]);


     

       
98

       
 

       



     

       
99

       
 

       
        Ok(Self {


     

       
100

       
-

       
            buffer: header_buffer


     

       
101

       
 

       
                .try_into()


     

       
102

       
 

       
                .map_err(|_| Error::CartridgeReadError)?,


     

       
103

       
 

       
            title: title_chars,


     
···

       
115

       
 

       
            global_checksum,


     

       
116

       
 

       
        })


     

       
117

       
 

       
    }


     

       
118

       
-

       



     

       
119

       
-

       
    fn print_test(&self) {


     

       
120

       
-

       
        for byte in self.buffer.iter() {


     

       
121

       
-

       
            print!("{} ", *byte as char);


     

       
122

       
-

       
        }


     

       
123

       
-

       
    }


     

       
124

       
 

       
}


     
···

       
5

       
 

       



     

       
6

       
 

       
pub struct CartridgeHeader {


     

       
7

       
 

       
    //Should be 80 bytes (0x014F(335) - 0x0100(256)) + 1 to include the last address


     

       
8

       
+

       
    pub _buffer: [u8; 80],


     

       
9

       
 

       
    pub title: [char; 16],


     

       
10

       
 

       
    pub manufacturer_code: [char; 4],


     

       
11

       
 

       
    pub cgb_flag: CGBFlag,


     
···

       
49

       
 

       
        for (i, true_logo_byte) in NINTENDO_LOGO.iter().enumerate() {


     

       
50

       
 

       
            let rom_byte = nintendo_logo_from_rom[i];


     

       
51

       
 

       
            if rom_byte != *true_logo_byte {


     

       
52

       
+

       
                return Err(Error::NotAValidRom);


     

       
53

       
 

       
            }


     

       
54

       
 

       
        }


     

       
55

       
 

       



     
···

       
97

       
 

       
        ]);


     

       
98

       
 

       



     

       
99

       
 

       
        Ok(Self {


     

       
100

       
+

       
            _buffer: header_buffer


     

       
101

       
 

       
                .try_into()


     

       
102

       
 

       
                .map_err(|_| Error::CartridgeReadError)?,


     

       
103

       
 

       
            title: title_chars,


     
···

       
115

       
 

       
            global_checksum,


     

       
116

       
 

       
        })


     

       
117

       
 

       
    }


     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       
118

       
 

       
}
+1 -1
src/enums.rs 
···

       
3

       
 

       
    CartridgeHeaderStart = 0x0100,


     

       
4

       
 

       
    CartridgeHeaderEnd = 0x014F,


     

       
5

       
 

       
    // 0100-0103 — Entry point


     

       
6

       
-

       
    EntryPointEnd = 0x0103,


     

       
7

       
 

       
    // 0104-0133 — Nintendo logo


     

       
8

       
 

       
    NintendoLogoStart = 0x0104,


     

       
9

       
 

       
    NintendoLogoEnd = 0x00133,


     
···

       
3

       
 

       
    CartridgeHeaderStart = 0x0100,


     

       
4

       
 

       
    CartridgeHeaderEnd = 0x014F,


     

       
5

       
 

       
    // 0100-0103 — Entry point


     

       
6

       
+

       
    _EntryPointEnd = 0x0103,


     

       
7

       
 

       
    // 0104-0133 — Nintendo logo


     

       
8

       
 

       
    NintendoLogoStart = 0x0104,


     

       
9

       
 

       
    NintendoLogoEnd = 0x00133,
+8 -1
README.md 
···

       
1

       
-

       
# GameBoyPlayground


     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     
···

       
1

       
+

       
# DMG Playground


     

       
2

       
+

       



     

       
3

       
+

       
Just some experiments with Gameboy emulation. Right now it just reads


     

       
4

       
+

       
the [Cartridge Header](https://gbdev.io/pandocs/The_Cartridge_Header.html) of a GB rom and parses it


     

       
5

       
+

       
out


     

       
6

       
+

       



     

       
7

       
+

       
1. Obtain a `LegallyObtainedRom.gb` and name it as such in the root of the project


     

       
8

       
+

       
2. `cargo run` You should see it list out things like the name of the game, etc