a2d/desktop
2018-01-12 19:06:55 -08:00
..
infos DeskTop: split invoker routine out 2018-01-07 11:45:52 -08:00
orig DeskTop: split invoker routine out 2018-01-07 11:45:52 -08:00
res Clean up directories, start work mapping DESKTOP2 2017-09-16 17:11:50 -07:00
.gitignore Add .gitignore for DeskTop dir 2017-09-18 20:31:16 -07:00
a2d.s DeskTop: Ensure all disassembled code is 6502 (no C) 2018-01-07 17:19:52 -08:00
asm.cfg DeskTop: Consolidate aux/main code into single source, split out GUI library 2018-01-04 14:18:24 -08:00
desktop.s DeskTop: more IDs 2018-01-12 19:06:55 -08:00
go.sh DeskTop: Initial disassembly of segments 5/6 2018-01-05 09:42:32 -08:00
invoker.s DeskTop: Remove some placeholder symbols 2018-01-07 21:53:39 -08:00
loader.s DeskTop: Remove some placeholder symbols 2018-01-07 21:53:39 -08:00
Makefile DeskTop: split invoker routine out 2018-01-07 11:45:52 -08:00
README.md DeskTop: complete diasm of screen dumper 2018-01-07 17:16:26 -08:00

DeskTop diassembly notes

DESKTOP.SYSTEM

A short (8k) loader program. This is likely responsible for copying the rest to a RAM card (if available), then invoking the main app.

DESKTOP2.$F1

This is large - 111k. It includes a loader, the DeskTop app (with both main memory and aux memory segments, filling everything from $4000 to $FFFF (except for I/O space and ProDOS), and still having more code - probably the disk copy code which is swapped in dynamically.

The file is broken down into multiple segments:

  • segment 0: load - address $2000-$257F, length $0580, file offset $000000 (Loader)
  • segment 1: aux1 - address $4000-$BFFF, length $8000, file offset $000580 (A2D, part of DeskTop)
  • segment 2: aux2 - address $D000-$ECFF, length $1D00, file offset $008580 (More of DeskTop)
  • segment 3: aux3 - address $FB00-$FFFF, length $0500, file offset $00A280 (More of DeskTop)
  • segment 4: main - address $4000-$BEFF, length $7F00, file offset $00A780 (More of DeskTop)
  • segment 5: main - address $0800-$0FFF, length $0800, file offset $012680 (Initializer)
  • segment 6: main - address $0290-$03EF, length $0160, file offset $012E80 (Invoker)
  • segment N: TBD - 38k so must be further subdivided. Disk Copy, and ...???

Structure

Loader

loader.s

Invoked at $2000; patches the ProDOS QUIT routine (at LC2 $D100) then invokes it. That gets copied to $1000-$11FF and run by ProDOS.

The invoked code stashes the current prefix and re-patches ProDOS with itself. It then (in a convoluted way) loads in the second $200 bytes of DESKTOP2 at $2000 and invokes that.

This code then loads the rest of the file as a sequence of segments, moving them to the appropriate destination in aux/banked/main memory.

There's fourth chunk of code, which expects to live at $280 so it can't co-exist with the Invoker; it may be temporary code, as there is no sign that it is ever moved into place. It's also unclear how it would be hooked in. The routine detects OA+CA+P and prints the DHR screen to an ImageWriter II printer attached to Slot 1. (This may have been used to produce screenshots during development for manuals.)

Invoker

invoker.s

Loaded at $290-$03EF, this small routine is used to invoke a target, e.g. a double-clicked file. System files are loaded/run at $2000, binary files at the location specified by their aux type, and BASIC files loaded by searching for BASIC.SYSTEM and running it with the pathname passed at $2006 (see ProDOS TLM).

Initializer

desktop.s

Loaded at $800-$FFF, this does one-time initialization of the DeskTop. It is later overwritten when any desk accessories are run.

GUI Library "A2D"

a2d.s

AUX $4000-$8DFF is the GUI library used for the DeskTop application and (presumably) for disk copy and Selector apps (TBD).

Entry point is $4000 with a ProDOS MLI-style calling convention

  • Font is at $8800

  • Part of $8500-$87FF looks like part of "DeskTop" (see below), dealing with online volumes.

"DeskTop" Application

desktop.s

DeskTop application code is in the lower 48k of both Aux and Main:

  • Aux $8E00-$BFFF - sitting above the GUI library
  • Main $4000-$BEFF

...and in the Aux language card area (accessible from both aux and main code) are relays, buffers and resources:

  • Aux $D000-$ECFF - relays and other aux/main helpers, resources (menus, strings, window)
  • Aux $ED00-$FAFF - hole for data buffer
  • Aux $FB00-$FFFF - more resources (file types, icons)

($C000-$CFFF is reserved for I/O, and main $BF page and language card is ProDOS)

       Main               Aux                 ROM
$FFFF +-------------+    +-------------+    +-------------+
      | ProDOS      |    | DeskTop     |    | Monitor     |
$F800 |             |    | Resources/  |    +-------------+
      |             |    | Buffers     |    | Applesoft   |
      |             |    |             |    |             |
      |             |    |             |    |             |
      |             |    |             |    |             |
$D000 +-------------+    +-------------+    +-------------+    +-------------+
                                                               | I/O         |
                                                               |             |
$C000 +-------------+    +-------------+                       +-------------+
      | ProDOS GP   |    | DeskTop     |
$BF00 +-------------+    | App Code    |
      | DeskTop     |    |             |
      | App Code    |    |             |
      |             |    |             |
      |             |    |             |
      |             |    |             |
      |             |    |             |
      |             |    |             |
      |             |    |             |
      |             |    |             |
      |             |    |             |
      |             |    |             |
      |             |    |             |
      |             |    |             |
$8E00 |             |    +-------------+
      |             |    | A2D GUI     |
      |             |    | Library     |
      |             |    |             |
      |             |    |             |
      |             |    |             |
      |             |    |             |
      |             |    |             |
      |             |    |             |
      |             |    |             |
      |             |    |             |
$4000 +-------------+    +-------------+
      | Graphics    |    | Graphics    |
      |             |    |             |
      |             |    |             |
      |             |    |             |
      |             |    |             |
      |             |    |             |
      |             |    |             |
      |             |    |             |
      |             |    |             |
$2000 +-------------+    +-------------+
      | Initializer |    | Desk Acc    |
      | & Desk Acc  |    |             |
      |             |    |             |
      |             |    |             |
$0800 +-------------+    +-------------+
      | Text        |    | Text        |
      |             |    |             |
$0400 +-------------+    +-------------+
      | Invoker     |    |             |
$0300 +-------------+    +-------------+
      | Input Buf   |    | Input Buf   |
$0200 +-------------+    +-------------+
      | Stack       |    | Stack       |
$0100 +-------------+    +-------------+
      | Zero Page   |    | Zero Page   |
$0000 +-------------+    +-------------+