ACME Cross-Assembler Build

This extension adds a custom build task which you can use in your CI pipelines to automate builds for programs written in assembly language for the ACME Cross-Assembler for 6502/6510/65816 CPUs.

This extension is still in preview. Please report any issues you might have so we can continue to improve it.

Usage

1. Install the extension.

2. Go to your VSTS or TFS project, click on the Build tab, and create a new build definition

3. Click Add build step and select ACME Cross-Assembler Build from the Build category

4. Configure the build task - Check out the tool tips for inline documentation

Configuration Options

The extension uses a few common configuration options

• Path to source file: relative path from repo root of your project sources which will be passed to ACME to assemble.
• Output file pattern: the output filename generated by ACME. This should be specified in the !to opcode of your source file (i.e. !to "myprog.prg",cbm ; output file). Defaults to *.prg
• ACME build arguments: (Optional) Additional arguments passed to ACME. Defaults to -v3 (maximum verbosity) which is useful for debugging the build

Task excecution

The task will automatically download the latest version of ACME Cross-Assembler and invokes it with the settings you specify to create the output file for the target platform.

The resulting output file(s) that match the pattern specified in the configuration settings are then copied to the Build.ArtifactStagingDirectory of your build agent.

Supported Agents

This extension supports both Hosted and Custom Windows Agents. Linux and MacOS agents are not currently supported.

About ACME

Marco Baye's ACME cross-assembler is a free crossassembler, released under the GNU General Public License. The current version can produce code for the 6502 (including illegal opcodes), 65c02 and 65816 processors.

This assembler has been ported to several platforms including Amiga, DOS, and Linux. It includes support the standard assembler stuff like global/local/anonymous labels, offset assembly, conditional assembly and looping assembly. It can include other source files as well as binaries while assembling.

Version History

Ver 0.3.6

• Updated to use the latest version of Acme Cross Assembler (0.96.4-1 Dec 2019)
• Improved download and installation method in Get-AcmeExecutalbe CmdLet
• Fixed bug in path execution command
  • Special thanks to Todd Whitehead for reporting this bug and for his ongoing support