viba's DUO Adept Emulator

Emulates the DUO Adept homebrew computer created by Jack Eisenmann.

why

i was bored

aren't there already like 2 of these that exist

yes!

how to use

By default the emulator will run (a slightly modified version of) the standard DUO Adept operating system. To execute a different machine code file, you can drag and drop it onto the window. If you extract the .love file like a zip archive, and run it from the command line, you can also specify a different machine code file (which must be located somewhere within that folder) like so:

love . file_to_run

The archive also includes an assembler, which if you have Lua installed, you can use like so:

lua assembler.lua input_file output_file

If no output file is specified, the assembled code will be written to a file named "out.bin".

Also included is a script that converts the textual output of JE's original assembler into a pure binary file. Use like so:

lua binaryConverter.lua input_file output_file

Default output file is "out.bin".

You can press certain function keys to do special things:

F1: Decrease the speed of execution by 4x

F2: Increase the speed of execution by 4x

F3: Show some information (version, registers, RAM, etc.)

F5: Pause the machine

F6: Execute a single instruction

F8: Restart the machine

NOTE: Some of the programs included in the default OS run according to the processor speed, so they may become unusable if the machine is running too fast. To resolve this, slow down the machine as described above.

todo

• Add support for the little beep boop speaker (finally!!!)
  • This will probably be a little difficult because there is no documentation anywhere about how the DUO Adept's sound output works, and no other emulator has ever implemented this functionality. "If only JavaScript had sound..." - Jack Eisenmann, 2011
• Maybe add more stuff to the information screen