a2d/desk.acc/README.md
2018-04-04 19:22:18 -07:00

2.2 KiB

Disassembly of the desk accessories:

  • Show Text File - in progress! 95% complete
  • Calculator - in progress! 99% complete
  • Date - in progress! 99% complete
  • Puzzle - in progress! 99% complete
  • Sort Directory - not started

New desk accessories:

Desk Accessory Details

  • Loaded at $800 through (at least) $14FF
  • Copy themselves from Main into Aux memory (same location)
  • Can call into ProDOS MLI and MGTK/A2D entry points ($4000, etc)
  • See API.md for programming details

Files

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

Build Instructions

On Unix-like systems (including Mac OS X) make all should build build the desk accessory files (original and new) into out/ output with a .$F1 suffix, representing the $F1 file type required.

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

Install Instructions

Transfer the .$F1 files to your Apple (real or virtual) ensuring you:

  • Drop the suffix
  • Replace . in the name with spaces
  • Ensure they have ProDOS file type $F1
  • Ensure they have start address $800

The last two are tricky, and depend on how you're copying the files. My process is to use Virtual ][ on my Mac and mount a folder as a ProDOS drive; I copy one of the original DAs into the folder which gives it the $F1 filetype as a suffix and start address as an invisible resource stream. I then unmount the folder, overwrite the DA with a newly built one, and remount the folder.

This is done by the res/go.sh script.

Finally:

  • Drop the files into your A2.DESKTOP\DESK.ACC folder
  • 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
    • Press Open-Apple and click on each file in the desired order
    • Select Sort Directory from the Apple menu, and verify the order
    • Restart