z88dk Tool — zcc
| Binary | zcc |
| Help | zcc + -h (target-specific clib/subtype lists) |
| Wiki (local draft) | wiki/tools/Tool---zcc.md |
Agent essentials
| Need | Flag |
|---|---|
| Quiet | -vn |
| See tool chain | -v |
| Map for ticks | -m |
| App image | -create-app |
| Compiler | -compiler=sccz80|sdcc|80cc|multi|… or target default |
| Float | --math32 / --math16 / --math-mbf32 … |
| CPU | often via -clib=8085 etc.; also -m8085 where applicable |
Env: PATH includes bin/, ZCCCFG=lib/config.
Pitfall: parallel bare zcc in one cwd can corrupt shared zcc_opt.def — sequential or separate dirs.
-compiler=multi compiles each C file with sccz80 and 80cc, then stitches one function body per name. Default metric is static ticks. Metric and report flags are --multi-compiler-metric and --multi-compiler-report (double dash; do not use a -compiler-* name). sdcc clibs are an ABI error. Spec: src/zcc-multi/zcc-compiler-multi.md.
Condensed reference (from wiki / tree)
Tool — zcc
zcc is the front end for compile, assemble, link, and optional appmake.
Quick start
zcc +cpm -vn hi.c -o hi
zcc +cpm -vn hi.c -o hi -create-app
zcc +cpm -clib=sdcc_iy -vn hi.c -o hi
zcc +zx -h
Always pass a target (+name or -target=name). Full learning path: Getting started.
Capability summary
| Area | Behaviour |
|---|---|
| Inputs | .c, preprocessed C, .asm / .s, .o, @list.lst |
| Compilers | `-compiler=sccz80 |
| Libraries | -clib= recipes from lib/config/<target>.cfg |
| Output | linker binary; -create-app runs appmake |
| Verbose | -v shows every tool command; -vn quiet |
-clib and -subtype lists in help are target-specific. The dump below was taken with zcc +zx -h on this tree. Run the same command for your target.
Methodology notes
| Need | zcc usage |
|---|---|
| Map for ticks / hotspots | Add -m (or -gen-map-file); pass the .map to ticks with -x |
| See every tool step | -v (not -vn) |
| Bound performance work | Classic +test + -DTIMER labels; see ticks |
| Float libraries | --math32 (full IEEE main) / --math16 (half adjunct; pair with a main lib for stdio); CPU-specific .lib via ZCC_LIBCPU |
| Quiet day-to-day | -vn |
Same compile line on both sides of an A/B library patch. Delete stale .bin/.map after installing a new library.
… (full reference: in-tree wiki page and live tool help)
Related
- Driver front end:
tool-zcc - Measurement:
methodology-measure,tool-ticks -compiler=multi:src/zcc-multi/zcc-compiler-multi.md