| Revision | eea6531ce6c97a2d753cbadc465e2e64efadb380 (tree) |
|---|---|
| Time | 2019-02-03 20:39:42 |
| Author | inglorion <homemicro@ingl...> |
| Commiter | inglorion |
documented how to use the emulator
docs/emulator.txt (diff)| @@ -0,0 +1,31 @@ | ||
| 1 | +#+TITLE: The Emulator | |
| 2 | + | |
| 3 | +The Home Micro source code repository contains an emulator that can be | |
| 4 | +used to run programs and firmware written for the Home Micro on other | |
| 5 | +computers. The source code for the emulator is in the emulator | |
| 6 | +directory of the repository. | |
| 7 | + | |
| 8 | +To start the emulator, a ROM image file named rom.bin must be present | |
| 9 | +in the directory the emulator is run from. In addition, to load a | |
| 10 | +program, a file named cartridge.bin must be present in the same | |
| 11 | +directory. | |
| 12 | + | |
| 13 | +The following commands, starting from the top of the Home Micro source | |
| 14 | +repository, will create a ROM image and a cartridge image and place | |
| 15 | +both in the emulator directory. The emulator will also be built and | |
| 16 | +invoked. The require that all the necessary software dependencies are | |
| 17 | +present on the system. For more information on those, see | |
| 18 | +[[file:requirements.txt]]. | |
| 19 | + | |
| 20 | +#+BEGIN_SRC sh | |
| 21 | +homemicro$ cd rom | |
| 22 | +rom$ make | |
| 23 | +rom$ cp rom.bin ../emulator/ | |
| 24 | +rom$ cd ../apps/testkeys | |
| 25 | +testkeys$ make | |
| 26 | +testkeys$ cp testkeys.bin ../../emulator/cartridge.bin | |
| 27 | +testkeys$ cd ../../emulator | |
| 28 | +emulator$ ./configure | |
| 29 | +emulator$ make | |
| 30 | +emulator$ ./hm1000 | |
| 31 | +#+END_SRC |
Fork