tool-asmpp

Preprocesses Z80 assembly source files with include paths and macro definitions.

1.1k|206|Updated Mar 16, 2016

Search Tags:#toolchain #assembler #assembly #preprocessor #macro #z88dk #z80

One-click install

npx skills add https://github.com/z88dk/z88dk --skill tool-asmpp-z88dk

Or copy as Structured Prompt for Agent▼

Please help me install this Agent Skill.
Skill: tool-asmpp
Source: https://github.com/z88dk/z88dk/tree/main/.agents/skills/tool-asmpp
Command: npx skills add https://github.com/z88dk/z88dk --skill tool-asmpp-z88dk

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Developers working with z88dk need to run the assembler preprocessor z88dk-asmpp on assembly sources, but its usage flags and role in the toolchain are sparsely documented. This Skill provides a condensed reference for invoking the preprocessor correctly. ## Core Features & Use Cases - Usage Reference: Documents the z88dk-asmpp command-line syntax including -I include paths, -D macro definitions, -v verbosity, and --ucase options. - Toolchain Context: Explains how asmpp relates to the zcc driver front end and measurement tools like ticks. - Use Case: When assembling a Z80 project that relies on conditional macros and include directories, consult this Skill to construct the correct z88dk-asmpp invocation before passing files to the assembler. ## Quick Start Ask the assistant to show how to run z88dk-asmpp on an assembly file with an include path and a defined macro.

Frequently Asked Questions about tool-asmpp

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I run the z88dk assembler preprocessor on a file?▼

Run z88dk-asmpp followed by options and the source files, for example z88dk-asmpp -Iinclude -DDEBUG file.asm. The -I flag adds include search paths and -D defines macros optionally with values.

What flags does z88dk-asmpp support?▼

z88dk-asmpp supports -Ipath for include directories, -Dvar[=value] for macro definitions, -v for verbose output, and --ucase for uppercasing. Multiple files can be passed in one invocation.

Do I need to call z88dk-asmpp directly when using zcc?▼

Usually not. The zcc front end drives the toolchain including preprocessing for normal compilations. Direct asmpp invocation is a niche case documented in the z88dk wiki under Tool---asmpp.

What is the difference between asmpp and the z88dk assembler?▼

asmpp is the assembler preprocessor that handles includes and macro expansion before assembly, while the assembler translates the preprocessed source into object code. asmpp prepares the input that later toolchain stages consume.