AGB emulator.
Find a file
2023-11-17 20:25:22 +01:00
src Add logo; Implement exceptions (including banked registers); Implement software interrupts; Add custom bootloader; Update readme; Support condition-setting instructions; Implement all data-processing instructions; Support conditional execution (predicates); Rework shifter instructions; Rework pipeline; Rework file structure; Update gitignore; Update naming convention; 2023-11-17 20:25:22 +01:00
.gitignore Add logo; Implement exceptions (including banked registers); Implement software interrupts; Add custom bootloader; Update readme; Support condition-setting instructions; Implement all data-processing instructions; Support conditional execution (predicates); Rework shifter instructions; Rework pipeline; Rework file structure; Update gitignore; Update naming convention; 2023-11-17 20:25:22 +01:00
bootloader.ld Add logo; Implement exceptions (including banked registers); Implement software interrupts; Add custom bootloader; Update readme; Support condition-setting instructions; Implement all data-processing instructions; Support conditional execution (predicates); Rework shifter instructions; Rework pipeline; Rework file structure; Update gitignore; Update naming convention; 2023-11-17 20:25:22 +01:00
bootloader.s Add logo; Implement exceptions (including banked registers); Implement software interrupts; Add custom bootloader; Update readme; Support condition-setting instructions; Implement all data-processing instructions; Support conditional execution (predicates); Rework shifter instructions; Rework pipeline; Rework file structure; Update gitignore; Update naming convention; 2023-11-17 20:25:22 +01:00
Cargo.toml Add logo; Implement exceptions (including banked registers); Implement software interrupts; Add custom bootloader; Update readme; Support condition-setting instructions; Implement all data-processing instructions; Support conditional execution (predicates); Rework shifter instructions; Rework pipeline; Rework file structure; Update gitignore; Update naming convention; 2023-11-17 20:25:22 +01:00
CHANGELOG.md Add logo; Implement exceptions (including banked registers); Implement software interrupts; Add custom bootloader; Update readme; Support condition-setting instructions; Implement all data-processing instructions; Support conditional execution (predicates); Rework shifter instructions; Rework pipeline; Rework file structure; Update gitignore; Update naming convention; 2023-11-17 20:25:22 +01:00
COPYING Implement Thumb: * ldr Rd, [Rn, Immediate5]; * ldr Rd, [Rn, Rm]; * ldr Rd, [pc, Immediate8]; * ldr Rd, [sp, Immediate8]; * lsl Rd, Rm, Immediate5; * svc Immediate8; * push Registers; * pop Registers; * strh Rd, [Rn, Immediate5]; * lsr Rd, Rm, Immediate5; Update readme; Rework instruction functions; Improve comments; Attach license file; Initialise SP; Optimise sign-extensions; Bump dependency versions 2023-07-05 20:48:23 +02:00
luma.svg Add logo; Implement exceptions (including banked registers); Implement software interrupts; Add custom bootloader; Update readme; Support condition-setting instructions; Implement all data-processing instructions; Support conditional execution (predicates); Rework shifter instructions; Rework pipeline; Rework file structure; Update gitignore; Update naming convention; 2023-11-17 20:25:22 +01:00
make_test.sh Add logo; Implement exceptions (including banked registers); Implement software interrupts; Add custom bootloader; Update readme; Support condition-setting instructions; Implement all data-processing instructions; Support conditional execution (predicates); Rework shifter instructions; Rework pipeline; Rework file structure; Update gitignore; Update naming convention; 2023-11-17 20:25:22 +01:00
README.md Add logo; Implement exceptions (including banked registers); Implement software interrupts; Add custom bootloader; Update readme; Support condition-setting instructions; Implement all data-processing instructions; Support conditional execution (predicates); Rework shifter instructions; Rework pipeline; Rework file structure; Update gitignore; Update naming convention; 2023-11-17 20:25:22 +01:00
test.ld Reformat changelog in Markdown; Add test program (including build script); Update readme (make Markdown); Rewrite and restructure project; Update optimisation flags; Depend on ctrlc, sdl2, and toml; Set window title according to image; Draw video memory; Update naming convention; Update gitignore; Never hang on trap; Run CPU on seperate thread; Rework logs; 2023-11-04 20:19:28 +01:00
test.s Add logo; Implement exceptions (including banked registers); Implement software interrupts; Add custom bootloader; Update readme; Support condition-setting instructions; Implement all data-processing instructions; Support conditional execution (predicates); Rework shifter instructions; Rework pipeline; Rework file structure; Update gitignore; Update naming convention; 2023-11-17 20:25:22 +01:00

Luma

Luma is an emulator for the AGB—Game Boy Advance platform.

Usage

luma [configuration]

Invoke the emulator via the luma command.

Configuration

The emulator tries to read the configuration file at ${HOME}/.luma.toml. If successful, the following fields are read (all must be present):

luma:

  • version: The configuration format (currently 0)

device:

  • bootloader: The path to the bootloader file
  • image: The path to the image file

video:

  • scale: The scale modifier applied to the screen (14294967295)

If a path is parsed as a terminal parameter, the configuration at that location is read instead.

Compatibility

Currently, the emulator has limited support for the Arm instruction set. All of the instructions used in the provided test program are however implemented.

The entire memory space (0x00000000 to 0x0E00FFFF) is available, however, no I/Omapped addresses are currently functional.

Improved support is, of course, planned.

Copyright & License

Copyright 20212023 Gabriel Bjørnager Jensen.

This program is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more details.

You should have received a copy of the GNU Affero General Public License along with this program. If not, see https://www.gnu.org/licenses/.