emuStudio Application
emuStudio is a desktop application which allows emulation of various computers. Besides emulation, it contains source code editor, which can be used to write and then compile programs then to be instantly emulated. Virtual computers, as the emulators are called, are represented by plugins of various type (compiler, memory, CPU and device), combined in a computer configuration. The computer configuration can be opened during startup.
The application has also command-line interface, which allows executing automatic “load-compile-emulate” workflow, possibly without graphical interface. This workflow is called “automatic emulation” and has its specifics, discussed per virtual computer.
A logger is used by emuStudio which helps debugging of the application and plugins.
Installation and run
At first, please download emuStudio distribution. It is either a TAR or ZIP file in the form emuStudio-[VERSION].zip
. For Linux/Mac environments, a TAR variant will be more suitable since it preserves file attributes and execution permissions. Unpack the file where you want to have emuStudio installed.
Before running, Java 11 or later must be installed. Then, emuStudio can be run by executing the following script:
- On Linux / Mac
> ./emuStudio
- On Windows:
> emuStudio.bat
NOTE: Currently supported are Linux and Windows. Mac is NOT supported, but it might work to some extent.
Command-line arguments
emuStudio accepts several command line arguments. Their description is accessible with --help
argument:
$ ./emuStudio --help
Usage: emuStudio [-hV] [-cl] [-i=FILE] [-cn=NAME | -cf=FILE | -ci=INDEX]
[COMMAND]
Universal emulation platform and framework
-cl, --computers-list
list all existing virtual computers
-h, --help Show this help message and exit.
-i, --input-file=FILE input file name (source code)
-V, --version Print version information and exit.
Virtual computer
-cf, --computer-file=FILE
virtual computer configuration file
-ci, --computer-index=INDEX
virtual computer index (see -cl for options)
-cn, --computer-name=NAME
virtual computer name (see -cl for options)
Commands:
automation, auto run emulation automation
Automation command has its own usage:
$ ./emuStudio auto --help
Usage: emuStudio automation [-hV] [--[no-]gui] [-s=ADDRESS] [-w=MILLIS]
run emulation automation
--[no-]gui show/don't show GUI during automation
-h, --help Show this help message and exit.
-s, --start-address=ADDRESS
program start address
-V, --version Print version information and exit.
-w, --waitmax=MILLIS limit emulation time to max MILLIS (force kill
afterwards)