This is a cache of https://vccplus.brianholman.com/manuals/software-storage-and-peripherals/floppy/. It is a snapshot of the page as it appeared on 2026-11-21T00:01:08.902+0000.
Put a program somewhere · Software, Storage, and Peripherals · VCC Plus
← 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 5: Software, Storage, and Peripherals

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

Download PDF
Contents

Chapter 1 of 8

Put a program somewhere

You’re about to make a disk small enough to send to a friend. It will hold a program called CARGO. When your friend runs it, their CoCo will say CARGO ORIGINAL. They need neither your running emulator nor the contents of its memory. What, exactly, do you have to send them?

Give the disk a home on the Mac

  1. Make a new folder in Finder for this book’s exercises. Choose a place where you can find it again. Select the empty, initialized practice disk. Save a copy in your folder as CARGO.DSK. In the app reader the link opens a save panel. In a browser, rename the downloaded copy in Finder. If you opened the book directly from its folder, you can also duplicate media/BLANK.DSK into your practice folder.
  2. Start in Disk BASIC. If a program is already in RAM, save anything you want to keep. To change setups, choose Machine → Configuration Profiles…, select Disk BASIC, then Load…. Read and confirm the restart. Resolve any pending work before switching.
  3. Choose Media → Floppy Disks…. Find FD0. Use Insert… on an empty drive, or Replace… on an occupied one. Choose the CARGO.DSK you just made. Read the filename in the FD0 row. On this disposable copy, leave Write protected and Temporary changes off under Disk options. The row should say Saves automatically.
  4. Resume the emulator with the Mac toolbar’s Run if it paused. Click the CoCo screen, or choose Input → Focus CoCo Display. Wait for the OK prompt.
The Floppy Disks window puts the Mac filename and save mode beside the FD0 label. This example uses an authored test disk; look for CARGO.DSK on yours.

In the original disk system, a cable ran between a controller in the cartridge slot and the drive. The FD-502 controller understood the computer’s requests to read and write. The physical drive held whichever floppy you put in it. Here, the device named FD0 plays the part of that first drive. The image in it can change while the drive keeps its name. One FD-502 can serve FD0 through FD3.

Put a line in the directory

At the BASIC prompt, type NEW and press Return to begin with empty program memory. Type the following line and press Return. You can also open the source in its own editor to see it beside the machine. For this exercise, enter the line on the CoCo so you can follow the disk operation yourself.

10 PRINT "CARGO ORIGINAL"

A numbered line goes into memory. Now type these two commands, pressing Return after each one and waiting for OK.

SAVE "CARGO:0"
DIR 0

Find CARGO and BAS together in the list. That is a BASIC file inside the emulated disk. The zero in the SAVE name selected guest drive zero. In the Disk BASIC profile, that drive is FD0. The new Mac file you should see in Finder is the CARGO.DSK you chose earlier. You can store several BASIC files inside one such image.

If someone asks for… Give them…
A line of BASIC to read or edit on the Mac The editable CARGO.bas source
The floppy they can put in a drive A copy of CARGO.DSK, after saving finishes
The name to type at the CoCo prompt CARGO, the BASIC program in the disk’s directory

Bring it back after NEW

Before clearing RAM, check FD0 for a completed save. If its row asks you to save pending changes, resolve that first. Enter the following, one command at a time:

NEW
LIST
LOAD "CARGO:0"
RUN

After LIST, you should see OK with no numbered lines. After RUN, you should see CARGO ORIGINAL and OK. The Mac Run button resumed the processor earlier. The word RUN here asked BASIC to execute the program it had just loaded. The result shows that the disk carried enough information to rebuild the program after RAM was cleared.

The guest first lists CARGO BAS on drive 0. After NEW and an empty LIST, LOAD and RUN recover CARGO ORIGINAL.

When the drive has finished, eject CARGO.DSK in Floppy Disks. The disk stays in your Finder folder. You’ll copy it to a different kind of device in the next chapter. If you’re picking up the book at that point, you can use the finished CARGO disk instead.

When someone hands you a different disk

Our practice file is a standard 35-track, single-sided Disk BASIC image. Old collections can also hold JVC sector images, DMK track images and VDK images. A DMK can retain details of a track that a plain list of sectors leaves out. The FD-502 sometimes recognizes DMK or VDK contents even when the name ends in .dsk. Save As… preserves the mounted representation. Renaming an image changes its label in Finder.

Start by mounting a copy with Write protected enabled. A protection flag inside a DMK or VDK header may lock that choice on. Check the software’s own loading instructions before assuming Disk BASIC can list its directory. An OS-9 disk can fit in a CoCo drive and still require OS-9 to interpret its files. The same distinction applies to software written for a different computer.

An initialized disk already has a directory ready for use. New Disk in the Floppy Disks window also offers Standard DSK, DMK Track Image and VDK Disk Image, but those begin as unformatted media in memory. A guest format prepares their directory and destroys any previous contents on the selected disk. This book supplies an initialized blank so you can learn to save and reload without formatting a drive. Use the media field guide when deciding what to do with an unfamiliar file.

Inspect the files from the Mac

Choose Edit… beside the occupied FD0 row to open Disk Image Editor. The CoCo pauses and is locked while that mounted image is being edited. The table shows files inside the disk, with actual allocation totals below it. Exporting a tokenized BASIC file preserves its disk bytes; it does not turn it into the editable text listing used by BASIC Development.

Import, rename and delete work on a private copy and support Undo/Redo. For a Disk BASIC import, choose the file type and ASCII or Binary / Tokenized metadata to match the bytes you already have. These choices do not translate text, tokenize BASIC or assemble a binary. Save Edited Copy… keeps a separate image. Applying to the mounted drive requires Restart and Apply, which clears guest RAM before it can use the changed filesystem. Closing without applying leaves the source unchanged and the CoCo paused.

For a separate file, Media → Floppy Disks… → Open Disk Image… opens the editor without mounting it. A supported raw OS-9 image can be browsed too, including folders and its File Information permissions. Editing has narrower format limits than mounting: DMK, VDK, unsupported OS-9 geometry and oversized images may mount normally yet be refused by the editor. Use the handbook procedure for those limits, protection and save choices.

Carry the disk to a real CoCo

If your real CoCo uses DriveWire, open the separate DriveWire for VCC Plus app with its remembered personal profile and connect its serial session. Its separate companion guide explains profiles, connections and recovery. Back in VCC Plus's Floppy Disks window, choose Actions → Send a Copy to DriveWire… on the occupied row. Pick that session and a DW0–DW3 slot, then choose Send Copy. DriveWire asks Allow for This Connection before accepting the first transfer on that connection.

This sends the current disk bytes, including guest changes still in memory. It does not save or modify the emulator's source image, pause the emulator or clear its unsaved-changes indication. The destination becomes a separate working copy. If a disk was already there, DriveWire retains its current bytes for recovery before replacing it. Stop guest disk activity and return the real CoCo to BASIC or reset before using changed media. Do not assume the physical CoCo's cached directory changes just because the Mac switched images.

DriveWire also reuses VCC Plus's editor and a disk-only Software Library. There is one catalog maintained by VCC Plus; you do not update another database in the DriveWire app. Install matching public versions of the two apps. For permission, format limits and the Show Received Disks… recovery folder, follow Send a floppy copy to a real CoCo.

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