VS64 - The C64 Development Environment
This extension provides support for C64 development in Visual Studio Code.
There are no additional requirements or dependencies to operate this extension.
Introduction and Basic Usage
The VS64 extension provides a convienient editing, build and run environment. This is done by providing syntax highlighting, automatic background compilation using the ACME assembler, an embedded 6502 CPU emulator and the integration of the VICE C64 emulator and the C64 debugger tool.
Support for ACME assember syntax is provided.
If compilation is successful, that program file can either be run/debugged with the embedded debugger based on a defined launch configuration (see Debugger Launch Configuration), or it can be loaded into a VICE emulator session or a C64 Debugger session.
If compilation fails, the ACME outputs are shown in the diagnostics view.
MOS 6502 CPU Emulator
The VS64 extension comes with a built-in 6502 CPU emulator that allows very fast edit-build-run cycles. The limitation is important to understand: it is not a full C64 emulation. It purely executes 6502 machine code as fast as possible - and integrates nicely to the Visual Studio Code debugger interface.
An active 6502 debugging session allows you to:
C64 Emulator Integration
If you have a VICE C64 emulator installed, you can configure the VS64 extension to use it. You trigger the VICE emulator using the
C64 Debugger Integration
If you have the
Please notice: You have to enable this in your settings.
To setup the C64 development environment, go to Preferences>Settings and check the following settings:
Path to assembler executable.
Additional assembler command line options.
Enable auto build before running or debugging.
Enable background build after source changes.
Flag to enable C64 debugger instead of emulator.
Path to C64 debugger executable.
Additional debugger command line options.
Path to emulator executable.
Additional emulator command line options.
Flag to enable verbose output of extension
Debugger Launch Configuration
In order to run a compiled C64 program (
Always needs to be "asm".
Always use "launch" here.
Any name you want to use is fine.
The default build output path is ".cache" within the workspace root folder.
A 16-bit address in decimal or $hexadecimal form.
The following extension commands are available to run a compiled program in either a C64 emulator (VICE) or the C64 debugger.
To trigger the commands, just open the Command Palette (or just press
Run the output program file (
If the C64 debugger tool is enabled, run the output program file (
This package includes open source from other developers and I would like to thank all of those:
Ideas Taken From