Running emulator

Prerequisites

To debug the extension needs a custom build of WinUAE or FS-UAE emulator. They are downloaded in background by the extension but if you want to build it yourself here are the projects :

• FS-UAE.
• WinUAE.

Prepare the workspace and build the program

Follow this wiki page and the build wiki page

Create a launch configuration and run !

Settings

The RUN configuration will start the emulator with a configuration.

The program must in set in the Startup-Sequence file if you want it to start with the emulator.

{
    "version": "0.2.0",
    "configurations": [
        {
            "label": "FS-UAE Run",
            "description": "A new configuration for running FS-UAE.",
            "body": {
                "type": "uae-run",
                "request": "launch",
                "name": "Run",
                "emulator": "${workspaceFolder}/bin/fs-uae",
                "windows": {
                    "emulator": "${workspaceFolder}/bin/fs-uae.exe"
                },
                "osx": {
                    "emulator": "${workspaceFolder}/bin/fs-uae"
                },
                "linux": {
                    "emulator": "${workspaceFolder}/bin/fs-uae"
                },
                "emulatorWorkingDir": "${workspaceFolder}/bin",
                "options": [
                    "--chip_memory=1024",
                    "--hard_drive_0=${workspaceFolder}/uae/dh0",
                    "--joystick_port_1=none",
                    "--amiga_model=A1200",
                    "--slow_memory=1792"
                ]
            },
            "preLaunchTask": "amigaassembly: build"
        },
        {
            "label": "WinUAE Run",
            "description": "A new configuration for running WinUAE.",
            "body": {
                "type": "uae-run",
                "request": "launch",
                "name": "Run",
                "emulator": "${workspaceFolder}/bin/winuae.exe",
                "emulatorWorkingDir": "${workspaceFolder}/bin",
                "options": [
                    "-s",
                    "quickstart=a500,1",
                    "-s",
                    "filesystem=rw,dh0:${workspaceFolder}\\uae\\dh0"
                ]
            },
            "preLaunchTask": "amigaassembly: build"
        }
    ]
}

option	description
type	'uae-run' for the fs-uae emulator
request	type of debugging method must be 'launch'
name	Name of the configuration
trace	If true logs will be added to the output console
emulatorWorkingDir	Working dir for the emulator run
emulator	File (with path) to the emulator binary
options	Options to send to the emulator (see fs-uae ou winuae options)
preLaunchTask	Set to "amigaassembly: build" to build the workspace before launch