a2d/desk.acc/README.md
Joshua Bell d8baeddbe0 Restore new DAs to fixes branch
This reverts commit 6788d153af.
2018-12-09 20:08:57 -08:00

3.7 KiB

Disassembly of the original desk accessories:

New desk accessories:

  • Show Image File
    • Select an image file (8k Hires or 16k Double Hires), then choose this DA to preview it.
  • This Apple
    • Gives details about the computer, expanded memory, and what's in each slot.
  • Eyes
    • Eyes that follow the mouse.
  • Screen Dump
    • Dumps a screenshot to an ImageWriter II attached to a Super Serial Card in Slot 1.

See API.md for programming details

Files

  • Makefile - cleans/builds targets
  • orig/*.bin - original binary (type $F1, auxtype $0640, start $800)
  • *.s - source (originally generated using da65, now modified)

Build Instructions

On Unix-like systems (including Mac OS X) make all should build the desk accessory files (original and new) into out/ output with a .built suffix.

For the original DAs, the .built and .bin files can be compared using diff to ensure that no changes have been introduced by the disassembly process.

With desk.acc as the current directory, run res/go.sh to automatically verify that the files are unchanged from the original, and also generate semi-useful stats showing disassembly progress.

Getting The DAs Onto Your Apple II

There are a handful of approaches for getting the files on your real or virtual Apple.

Create a Disk Image

To produce a ProDOS disk image with the DA files, install and build the Cadius tool:

git clone https://github.com/mach-kernel/cadius /tmp/cadius
make -C /tmp/cadius
CADIUS=/tmp/cadius/bin/release/cadius

Then from the desk.acc/ directory, run: go/package.sh

This will generate: desk.acc/out/DeskAccessories.po

Mount this disk image in your emulator, or transfer it to a real floppy with ADTPro, then follow the install instructions below.

Mount Folder in Virtual ][

If you use Virtual ][ as your emulator, you can skip creating a disk image.

At the top level of the repo, run res/go.sh to build all targets, then run res/mount.sh. This will create a mount/ folder and the built files will automatically be copied in. Then run Virtual ][ and use the Media > Mount Folder as ProDOS Disk... menu item, then select the mount/ folder. A new ProDOS volume called /MOUNT will be available. (Tip: use the Special > Check Drives command in A2D to make it appear.)

(The res/go.sh script will helpfully run res/mount.sh automatically if the mount/ folder already exists.)

Other

If you need to copy the files some other way (e.g. via CiderPress), you need to do the following:

Transfer the .built files in the out directory, ensuring you:

  • Drop the .built suffix
  • Ensure they have ProDOS file type $F1
  • Ensure they have start address $0800
  • Ensure they have auxtype $0640 (to match the originals)

The last three are tricky, and depend on how you're copying the files.

Install Instructions

Once you have the files accessible on your Apple:

  • Copy the files into your A2.DESKTOP/DESK.ACC folder (using A2D or any other tool)
  • Restart so A2D picks up the new DA

Tips:

  • You can use the Sort Directory DA to order the files, which controls the menu order:
    • Open the A2.DESKTOP/DESK.ACC folder
    • Hold Open-Apple and click on each file in the desired order
    • Select Sort Directory from the Apple menu, and verify the order
    • Restart