nescore 0.2.0

NES emulator
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
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173

use nescore::{Nes, Cartridge};

// #[test]
// fn corner_test() {
//     let prg = vec![
//                           // -- Set PPU ADDR to nametable address $2000
//         0xA9, 0x20,       // LDA $20
//         0x8D, 0x06, 0x20, // STA $2006; PPU ADDR
//         0xA9, 0x00,       // LDA $00
//         0x8D, 0x06, 0x20, // STA $2006; PPU ADDR

//                           // -- Set PPU DATA to $01
//         0xA9, 0x01,       // LDA $01
//         0x8D, 0x07, 0x20, // STA $2007; PPU DATA

//                           // -- Set PPU ADDR to nametable address $23BF
//         0xA9, 0x23,       // LDA $23
//         0x8D, 0x06, 0x20, // STA $2006; PPU ADDR
//         0xA9, 0xBF,       // LDA $BF
//         0x8D, 0x06, 0x20, // STA $2006; PPU ADDR

//                           // -- Set PPU DATA to $01
//         0xA9, 0x02,       // LDA $02
//         0x8D, 0x07, 0x20, // STA $2007; PPU DATA

//                           // -- Set PPU ADDR to attribute location $23C0
//         0xA9, 0x23,       // LDA $23
//         0x8D, 0x06, 0x20, // STA $2006; PPU ADDR
//         0xA9, 0xC0,       // LDA $C0
//         0x8D, 0x06, 0x20, // STA $2006; PPU ADDR

//                           // -- Set PPU DATA to $01
//         0xA9, 0x01,       // LDA $01
//         0x8D, 0x07, 0x20, // STA $2007; PPU DATA

//                           // -- Set PPU ADDR to attribute location $23FF
//         0xA9, 0x23,       // LDA $23
//         0x8D, 0x06, 0x20, // STA $2006; PPU ADDR
//         0xA9, 0xFF,       // LDA $C0
//         0x8D, 0x06, 0x20, // STA $2006; PPU ADDR

//                           // -- Set PPU DATA to $01
//         0xA9, 0x01,       // LDA $01
//         0x8D, 0x07, 0x20, // STA $2007; PPU DATA

//                           // -- Set PPU ADDR to palette location $3F05
//         0xA9, 0x3F,       // LDA $3F
//         0x8D, 0x06, 0x20, // STA $2006; PPU ADDR
//         0xA9, 0x05,       // LDA $05
//         0x8D, 0x06, 0x20, // STA $2006; PPU ADDR

//                           // -- Set PPU DATA to $01
//         0xA9, 0x01,       // LDA $01
//         0x8D, 0x07, 0x20, // STA $2007; PPU DATA

//         0x4C, 0x00, 0x80, // Loop
//     ];

//     let cart = init_cart(prg);
//     let mut nes = Nes::default().with_cart(cart).entry(0x8000).debug_mode(false);

//     let framebuffer = nes.emulate_frame();
//     let size = framebuffer.len();

//     for (i, byte) in framebuffer.iter().enumerate() {
//         if *byte == 45 {
//             println!("Found at: {} (${:04X}) - {}", i, i, size);
//         }
//     }

//     let pixel1 = (framebuffer[0], framebuffer[1], framebuffer[2]);
//     let pixel2 = (framebuffer[size-3], framebuffer[size-2], framebuffer[size-1]);

//     assert_eq!(pixel1, pixel2);
// }

#[test]
#[ignore] // Pretty sure this fails due to incorrect setup of scroll behaviour, given that actual games seem fine
fn render_one_pixel() {
    let prg = vec![
                          // Wait for VBlank
        0xA9, 0x80,       // LDA $80
        0x2D, 0x02, 0x20, // AND $2002
        0xF0, 0xF9,       // BEQ $FE

                          // -- Set PPU ADDR to nametable address $2000
        0xA9, 0x20,       // LDA $20
        0x8D, 0x06, 0x20, // STA $2006; PPU ADDR
        0xA9, 0x00,       // LDA $00
        0x8D, 0x06, 0x20, // STA $2006; PPU ADDR

                          // -- Set PPU DATA to $01
        0xA9, 0x01,       // LDA $01
        0x8D, 0x07, 0x20, // STA $2007; PPU DATA

                          // -- Set PPU ADDR to attribute location $23C0
        0xA9, 0x23,       // LDA $23
        0x8D, 0x06, 0x20, // STA $2006; PPU ADDR
        0xA9, 0xC0,       // LDA $C0
        0x8D, 0x06, 0x20, // STA $2006; PPU ADDR

                          // -- Set PPU DATA to $01
        0xA9, 0x01,       // LDA $01
        0x8D, 0x07, 0x20, // STA $2007; PPU DATA

                          // -- Set PPU ADDR to palette location $3F05
        0xA9, 0x3F,       // LDA $3F
        0x8D, 0x06, 0x20, // STA $2006; PPU ADDR
        0xA9, 0x05,       // LDA $05
        0x8D, 0x06, 0x20, // STA $2006; PPU ADDR

                          // -- Set PPU DATA to $01
        0xA9, 0x01,       // LDA $01
        0x8D, 0x07, 0x20, // STA $2007; PPU DATA

                          // -- Zero scroll
        0xA9, 0x00,       // LDA $20
        0x8D, 0x05, 0x20, // STA $2005; PPU SCROLL
        0xA9, 0x00,       // LDA $00
        0x8D, 0x05, 0x20, // STA $2005; PPU SCROLL

                          // -- Enable background rendering
        0xA9, 0x0A,       // LDA $0A
        0x8D, 0x01, 0x20, // STA $2001; PPU MASK

        0xA9, 0x00,       // LDA $00
        0xF0, 0xFE,       // BEQ $FE
    ];

    let cart = init_cart(prg);
    let mut nes = Nes::default().with_cart(cart).entry(0x8000).debug_mode(false);

    // Now actually run a frame we care about..
    let (framebuffer, _) = nes.emulate_frame();
    let rgb1 = (framebuffer[0], framebuffer[1], framebuffer[2]);
    let rgb2 = (framebuffer[3], framebuffer[4], framebuffer[5]);

    assert_eq!(rgb1, (0x00, 0x2D, 0x69));
    assert_ne!(rgb1, rgb2);
}

fn  init_cart(mut prg_rom: Vec<u8>) -> Cartridge {
    let header = init_header(1, 1);

    // pattern data
    let mut chr_rom = [0x00u8; 0x2000];
    chr_rom[0x10] = 0x80;
    chr_rom[0x27] = 0x01;

    prg_rom.resize(0x4000, 0x00);

    let rom = [&header[..], &prg_rom[..], &chr_rom[..]].concat();

    Cartridge::from(rom).unwrap()
}

fn init_header(num_prg_banks: u8, num_chr_banks: u8) -> [u8; 16] {
    [
        0x4E, 0x45, 0x53, 0x1A, // NES<EOF>
        num_prg_banks,          // PRG ROM
        num_chr_banks,          // CHR ROM
        0x00,                   // Flag 6
        0x00,                   // Flag 7
        0x00,                   // Flag 8
        0x00,                   // Flag 9
        0x00,                   // Flag 10
        0x00,                   // Flag 11
        0x00,                   // Flag 12
        0x00,                   // Flag 13
        0x00,                   // Flag 14
        0x00,                   // Flag 15
    ]
}