This extension adds a custom task which you can use in your CI pipelines to automate builds and create a stand alone disk image for your 8-Bit Commodore CBM projects.
This extension is still in preview. Please report any issues you might have so we can continue to improve it.
Usage
Install the extension.
Go to your VSTS or TFS project, click on the Build tab, and create a new build definition
Click Add build step and select Create Commodore Disk Image from the Package category
Configure the build task - Check out the tool tips for inline documentation
Configuration Options
The extension uses a few common configuration options
Disk name: a unique name for your media. This name will be used as the name of the Commodore disk as well as the name of the disk image file. The disk name can be a maximum of 16 alpha-numeric characters, spaces are not permitted.
Disk image type: the format type for disk image to be created in defined by the model of the Commodore disk drive you are targeting. You can select from the following types:
- Commodore 1541 - produces a file with a
.d64 extension
- Commodore 1541 GCR coding - produces a file with a
.g64 extension
- Commodore 1571 - produces a file with a
.d71 extension
- Commodore 1571 GCR coding - produces a file with a
.g71 extension
- Commodore 1581 - produces a file with a
.d81 extension
Path to source file: the location of the program file on the build agent to add to your disk. Defaults to $(build.artifactstagingdirectory)
Source file: the Commodore compatable file to add to your disk image. IMPORTANT Even though the default value is *.prg this option does not support wildcards. A full name must be provided.
Task excecution
The task will automatically download a copy of c1541, a disk image maintenance utility that is included as part of the VICE Commodore Emulator package. Once installed on your build agent, it invokes the necessary commands with the settings you specify to create the output file for the target platform.
Supported Agents
This extension supports both Hosted and Custom Windows Agents. Linux and MacOS agents are not currently supported.
About VICE - the Versatile Commodore Emulator
VICE is a program that runs on a Unix, MS-DOS, Win32, OS/2, BeOS, QNX 4.x, QNX 6.x, Amiga, Syllable or Mac OS X machine and executes programs intended for the old 8-bit computers.
The current version emulates the C64, the C64DTV, the C128, the VIC20, practically all PET models, the PLUS4 and the CBM-II (aka C610/C510). An extra emulator is provided for C64 expanded with the CMD SuperCPU.
c1541 Disk Image Utility
Please vist the c1541 homepage for additional information and documentation on the c1541 stand alone disk utility.
