blob: ee88b42ea9119b6b59c3b9fc516e7823066354ce (
plain) (
blame)
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
|
# 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 (1-4294967295)
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/O-mapped addresses are currently functional.
Improved support is, of course, planned.
# Copyright & License
Copyright 2021-2023 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/>.
|
