Getting Started - Set up emulator

Per default on a fresh install without previous saved settings an emulator add wizard should appear and ask for the location of an emulator. This wizard is pretty self explanatory, so here only the adding of a new emulator is described.


Open Preferences



Open the preferences dialog from the main menu (File -> Preferences)




Choose the "Tools" tab


Setting up emulator entry

Click the green plus icon below the list of entries to add a new (or double plus to clone an existing entry).



The image shows the setup of the later VICE emulator, with debugging and true drive settings.
For older VICE version you need to use the remote monitor interface, see below on how to enable.


Most arguments allow macros to be filled with project relevant data. See below for a list. These settings are available for configuration:

Name
A text description


Type
Allows the distinction between assembler and emulator. Currently only emulator is useful


Executable
Executable file of emulator


Working Path
Path to set when running the executable


PRG/T64
Argument to pass the media to start when it's a tape or disk image


Cartridge
Argument to pass the media to start when it's a cartridge


Debug
Extra Argument to pass when the emulator is started in debugging mode

Default interface with older VICE versions:
-initbreak 0x$(DebugStartAddressHex) -remotemonitor
Starting with VICE 3.5 the new binary remote interface is available. Starting with VICE 3.6 the old remote monitor interface was removed. To use the new binary interface set these arguments for Debug:
-initbreak 0x$(DebugStartAddressHex) -binarymonitor -binarymonitoraddress 127.0.0.1:6510

True Drive On
Argument to pass when true drive emulation is required

Pre VICE 3.6 this was
-truedrive +virtualdev
With VICE 3.6 and higher you have to pass
-drive8truedrive +virtualdev8

True Drive Off
Argument to pass when true drive emulation is not wanted
Pre VICE 3.6 this was "+truedrive -virtualdev", with VICE 3.6 and higher you have to pass "+drive8truedrive -virtualdev8"
Pre VICE 3.6 this was
+truedrive -virtualdev
With VICE 3.6 and higher you have to pass
+drive8truedrive -virtualdev8


Forward labels to emulator
When checked the labels are passed on (support for VICE and C64Debugger)