46 lines
2.9 KiB
Markdown
46 lines
2.9 KiB
Markdown
# Hello Disk — CMOC project example
|
||
|
||
An authored VCC Plus example under GPL-3.0-or-later, using the public-domain,
|
||
ROM-backed decbfile library included in the development runtime. No game source,
|
||
ROM, third-party standalone disk driver, generated executable, or disk image is
|
||
included in this example.
|
||
|
||
1. In VCC Plus choose **Develop → C Development → New** and select **Hello Disk — multi-file disk example** (the default). Choose a new writable folder.
|
||
2. Alternatively, copy this repository folder and **Open** it. Both approaches create your own editable source; the installed template stays unchanged.
|
||
3. **Project Settings** shows the source files, include directory, disk library,
|
||
generated resource recipe and disk launch command. Its Makefile is generated
|
||
using the same settings available in that window.
|
||
4. Boot the **Disk BASIC** machine profile. **Build** creates `HELLO.bin` and a
|
||
`HELLO.dsk` containing the executable and `WORDS.DAT`, entirely in the isolated
|
||
build workspace. It does not alter your source folder or mounted disks.
|
||
5. Use the disk launch control to mount the development disk in FD0 and run the
|
||
configured `DOS` command. You can also type `LOADM"HELLO":EXEC` at BASIC.
|
||
Confirm the media replacement when
|
||
prompted; retain any existing unsaved disk changes first.
|
||
6. The program reads its words from the emulated floppy through the Disk BASIC
|
||
ROM, prints them, then reports disk result `0` and generated word count `5`.
|
||
|
||
`main.c` calls functions in `src/display.c` and `src/disk.c`. Their shared header
|
||
is `include/hello.h`. A short Perl build recipe turns `assets/words.txt` into a C
|
||
translation unit and disk data together. Change the word list, build again and
|
||
observe the regenerated outputs. Add a breakpoint on an executable C line to
|
||
inspect the program using the existing debugger. Generated C can be inspected
|
||
from the frozen build snapshot; the editable input is the word list and recipe.
|
||
|
||
**Project Settings → Disk & Run → DOS boot** defaults to **Run this program**
|
||
for new Hello Disk copies. The build creates a small public-domain loader from
|
||
Pierre Sarrazin’s `autostart.c` under `obj/vcc-dos-boot` and reserves track 34
|
||
before adding files. It does not add a C source file to your editable project.
|
||
Choose **None** to build a disk without DOS boot. Existing project copies are
|
||
not changed automatically. Building or mounting alone does not run the program.
|
||
|
||
For command-line builds, put VCC Plus's `Contents/Resources/Toolchain/bin` on
|
||
`PATH` and run its bundled `make disk`. `make VCC_CONFIGURATION=Release disk`
|
||
uses the optimized configuration. Source changes are tracked through CMOC `.d`
|
||
header dependencies. `make clean` removes generated objects, data and disks.
|
||
Unlike the native app's isolated build, command-line Make writes these outputs
|
||
in this folder.
|
||
|
||
This example needs a functioning CoCo/Disk BASIC ROM configuration and keeps
|
||
those ROM services mapped. It is not a standalone-ROM-free disk implementation.
|