← Manual LibraryVCC Plus 3.7.1 · Reading on the web

Try the exercises in VCC Plus. Example links download files here; open them in the app to work beside the emulator.

The complete book · PDF editionBook 4: The VCC Plus User’s Handbook

77 pages · VCC Plus 3.7.1 · Keep a copy to read or print.

Download PDF
Contents

Appendix A

Look up a control

If you remember a word from a button, search this book from Book contents. If you remember which menu you opened, use the directory below. When something has gone wrong and you have no idea what the control is called, start with Get back to a working setup.

Visible controls on the desk

Control Where it leads
Profile name or Profiles Saved setups. A modified setup can be saved separately before you load another one.
Run / Pause Change whether the CPU is executing. At a deliberate source stop, use the source debugger when you want to continue stepping there.
Restart Soft Reset or Cold Restart. Read the consequence for RAM before choosing.
Media, Settings Shortcuts to device and machine windows. Open Printer Output or the tape recorder to keep a guest print job or a recording.
Devices, Connections, Show Clickable Areas Find a target, reveal its wiring, or see where you can click. For a partly covered cartridge, use the Devices list.
Expand monitor, Return to system Enlarge the live monitor and put it back while the program continues.
ⓘ, FD, HD, Tape in the footer Read the current profile's guide or inspect the named attachment. If there is a warning, follow A save needs attention.
Wooden shelf Browse software. The separate Manual Library is in Help.
Header camera and shared options Take a PNG using the remembered None/5/10-second timer. Choose the shared Save To folder and optional video audio in the menu; only the camera starts the screenshot.
Header video / Stop Recording Record a CoCo MP4 with optional CoCo audio. Red state and elapsed time identify an active recording. Host shutter/start cues are excluded from the movie.

Inside settings and inspectors

If you know the control's name Open this section
Advanced Filters, Edition, Environment, Format, Setup Choose a version that fits
Apply and Restart, Cold Restart, Soft Reset Pause, reset or restart? and the memory experiment
Build History, Call Stack, Launch Disk, Project Settings (C) Follow a C build
Capture, Follow Output, Export Raw Bytes Catch output from the printer
Clock enabled, Allow guest to set the virtual clock Use a virtual hard disk
Controller Test, Dead zone, Fire 1, Fire 2, Swap assignments Follow the thumbstick and fire button
CPU overclock, Fast-forward, Present frames Speed, frames and sound
Create Fresh Starter Media, Save as My Profile, Save Current As Make a personal setup
Debug from Entry, Set Stop, Export Binary Stop at the first assembly instruction
Enable DriveWire networking, Forget Mac Shell Permission Let OS-9 connect
Edit…, Open Disk Image…, Restart and Apply Edit files inside a disk image
Volume in Disk Image Editor Choose the OS-9 filesystem or numbered HDB-DOS disk inside a hard-drive image
Move To… in Disk Image Editor Move selected OS-9 files to another folder in the same image; Undo restores their original locations.
Export Tape, Fast CAS, New Recording, Rewind Play or record a tape
Graphics Preview, MMU, Memory Tools, Set PC, Trace Look inside the machine
Hardware Defaults, Memory, Restore Bundled System ROM Choose processor, memory and ROM
Install Only, Download & Play, Stop Automatic Loading Install or play
Getting Started, Restart & Play Start a curated game with its verified memory, video and loading setup
Open Source…, Show Source Folder Make a personal source project and open it without building or running
Read Manual, Online Manual Read a cached PDF or visit the project's online reading edition
Library Actions, Add Personal Software…, Personal Library Keep privately owned software on this Mac, with retained originals and writable working media.
Submit Software… Offer a title for public inclusion or follow the removal/withdrawal link. Opening a form does not submit files.
Guides & References Open a related walkthrough, map or software reference in Archive Library.
Manual Bookmark this location, Bookmarks Keep one bookmark list with All Books / This Book filters. Automatic reading resume is separate.
Capture Settings…, Recover MP4 Choose the shared capture folder, screenshot timer and video audio, or inspect a retained recording.
Live ROM, I/O ports, SD card folder, Startup slot Follow cartridges and the card folder
Read from CoCo, Renumber, Step Out, Watches (BASIC) Bring a BASIC program into the editor
Read-only connection, Review and Run, Allow Disposable Playtests, project refresh Choose assistant permissions and refresh the right project
Save As, Temporary changes, Write protected on a drive Keep a floppy safe
Scanlines, Smooth, Sharp, Integer Pixels Give the monitor more room
Update from Current, Rename, Replace, Export a profile Manage the saved entry

Use an assembler listing in the machine debugger

Choose Debug → Show Debugger → Inspector, switch the code view from Disassembly to Source, and choose Open Listing…. Supply the final absolute LWASM listing for the program already loaded in the CoCo. Opening the listing changes what you see. The machine keeps its program, memory and run state.

  • Follow PC selects a line when the program counter exactly matches a listed address. Turn it off to keep a line in view while you browse.
  • Find Next searches source text and filenames. An addressed row has a breakpoint circle. Several listing lines can share an address, and the CPU will stop at that address regardless of which of those lines you selected.
  • Control-click an addressed row for Show Disassembly or Show in Memory. Compare the listed instruction with the current mapped bytes when a stop looks wrong. Set PC Here changes where execution resumes and is available only when editing is allowed.

The standalone importer reads addresses from the listing and does not check the loaded bytes against it. A relocatable object listing contains section offsets that still need a linker map. Use the linked assembly project workflow or C source debugger for projects built in those workspaces. They associate the final build with the code that is launched.

Practice files

Open KEYS.bas to try the half-entered flight number. Open LANDPAD.bas to compare composite and RGB. In the app, each link opens a separate editable BASIC example. In a browser it downloads the source file. Running an example transfers its program into the emulated computer. Save any guest program you want to keep first.

The saved-line exercise works directly at the BASIC prompt. It needs an initialized, writable practice floppy in FD0. You can create a profile with fresh starter media first. The expected result is one saved line on disk and one later edit that exists only in RAM.

Original VCC Plus manuals © 2026 Brian K. Holman. Third-party references retain their authors’ copyrights and licenses. Artwork notices. Edition 3.7.1; source and export identity. Printable edition: PDF source and export identity.

A closer look

Open original