gba_test 0.5.0

Testing framework for the Game Boy Advance.
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

use crate::mmio::DmaControl;
use core::arch::global_asm;

const MMIO_BASE: usize = 0x0400_0000;
const WAITCNT_OFFSET: usize = 0x0000_0204;
const DMA_32_BIT_MEMCPY: DmaControl = DmaControl::new().with_transfer_32bit().with_enabled();
const DMA3_OFFSET: usize = 0x0000_00D4;
const IME_OFFSET: usize = 0x0000_0208;

global_asm! {
    ".section .entrypoint,\"ax\",%progbits",
    ".global __start",
    "__start:",

    ".code 32",

    "b 1f",
    ".space 188", /* space for header */
    "b 1f",
    ".byte 0",
    ".byte 0",
    ".space 26",

    "1:", /* post header */
    "mov r12, #{mmio_base}",
    "add r0, r12, #{waitcnt_offset}",
    "ldr r1, ={waitcnt_setting}",
    "strh r1, [r0]",

    /* iwram copy */
    "ldr r4, =__iwram_word_copy_count",
    "cmp r4, #0",
    "beq 2 f",
    "add r3, r12, #{dma3_offset}",
    "mov r5, #{dma3_setting}",
    "ldr r0, =__iwram_start",
    "ldr r2, =__iwram_position_in_rom",
    "str r2, [r3]", /* source */
    "str r0, [r3, #4]", /* destination */
    "strh r4, [r3, #8]", /* word count */
    "strh r5, [r3, #10]", /* set control bits */
    "2:",

    /* bss zero */
    "ldr r4, =__bss_word_clear_count",
    "cmp r4, #0",
    "beq 4 f",
    "ldr r0, =__bss_start",
    "mov r2, #0",
    "2:",
    "str r2, [r0], #4",
    "subs r4, r4, #1",
    "bne 2b",
    "4:",

    /* assign the runtime irq handler */
    "ldr r1, =__runtime_irq_handler",
    "str r1, [r12, #-4]",

    // Soft reset return to RAM.
    "mov r1, #1",
    "strh r1, [r12, #-6]",

    /* call to rust main */
    "ldr r0, =main",
    "bx r0",
    // main shouldn't return, but if it does just SoftReset
    "swi #0",

    ".code 16",

    mmio_base = const MMIO_BASE,
    waitcnt_offset = const WAITCNT_OFFSET,
    waitcnt_setting = const 0x4317 /*sram8,r0:3.1,r1:4.2,r2:8.2,no_phi,prefetch*/,
    dma3_offset = const DMA3_OFFSET,
    dma3_setting = const DMA_32_BIT_MEMCPY.to_u16(),
}

global_asm! {
    ".section .iwram.runtime.irq.handler,\"ax\",%progbits",
    ".global __runtime_irq_handler",
    "__runtime_irq_handler:",

    ".code 32",

    /* swap IME off, user can turn it back on if they want */
    "add r12, r0, #{ime_offset}",
    "mov r3, #0",
    "swp r3, r3, [r12]",

    /* Read/Update IE and IF */
    "ldr r0, [r12, #-8]",
    "and r0, r0, r0, LSR #16",
    "strh r0, [r12, #-6]",

    /* Read/Update BIOS_IF */
    "sub  r2, r12, #(0x208+8)",
    "ldrh r1, [r2]",
    "orr  r1, r1, r0",
    "strh r1, [r2]",

    /* Restore initial IME setting and return */
    "swp r3, r3, [r12]",
    "bx lr",

    ".code 16",

    ime_offset = const IME_OFFSET,
}

#[unsafe(no_mangle)]
pub fn __sync_synchronize() {}