Apple-2-SW/a2d
1
0
Fork 0
mirror of https://github.com/mi57730/a2d.git synced 2025-08-12 22:25:08 +00:00
Code Issues Projects Releases Wiki Activity

Update README.md

Browse Source
This commit is contained in:
Joshua Bell
2018-04-21 08:42:29 -07:00
committed by GitHub
parent bdabadc411
commit b070cf0864
1 changed files with 28 additions and 8 deletions
Download Patch File Download Diff File Expand all files Collapse all files

36
desk.acc/README.md
View File

@@ -1,14 +1,15 @@
Disassembly of the desk accessories: Disassembly of the original desk accessories:
* [Calculator](calculator.s) - complete!
* [Date](date.s) - complete!
* [Puzzle](puzzle.s) - complete!
* [Show Text File](show.text.file.s) - in progress! 95% complete * [Show Text File](show.text.file.s) - in progress! 95% complete
* [Calculator](calculator.s) - in progress! 99% complete * [Sort Directory](sort.directory.s) - in progress! 40% complete
* [Date](date.s) - in progress! 99% complete
* [Puzzle](puzzle.s) - in progress! 99% complete
* Sort Directory - _not started_
New desk accessories: New desk accessories:
* [Show Image File](show.image.file.s) - complete! * [Show Image File](show.image.file.s) - complete!
* [This Apple](this.apple.s) - complete! * [This Apple](this.apple.s) - complete!
* [Eyes](eyes.s) - complete!
## Desk Accessory Details ## Desk Accessory Details
@@ -20,7 +21,7 @@ New desk accessories:
## Files ## Files
* `Makefile` - cleans/builds targets * `Makefile` - cleans/builds targets
* `orig/*.bin` - original binary (type $F1, start $800) * `orig/*.bin` - original binary (type $F1, auxtype $0640, start $800)
* `*.s` - source (originally generated using da65, now modified) * `*.s` - source (originally generated using da65, now modified)
## Build Instructions ## Build Instructions
@@ -29,7 +30,7 @@ On Unix-like systems (including Mac OS X) `make all` should build
build the desk accessory files (original and new) into `out/` build the desk accessory files (original and new) into `out/`
output with a `.$F1` suffix, representing the $F1 file type required. output with a `.$F1` suffix, representing the $F1 file type required.
For the original DAs, the `.F1` and `.bin` files can be compared For the original DAs, the `.$F1` and `.bin` files can be compared
using `diff` to ensure that no changes have been introduced by the using `diff` to ensure that no changes have been introduced by the
disassembly process. disassembly process.
@@ -44,7 +45,7 @@ Transfer the `.$F1` files to your Apple (real or virtual) ensuring you:
* Ensure they have start address `$800` * Ensure they have start address `$800`
The last two are tricky, and depend on how you're copying the files. 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 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 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 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 resource stream. I then unmount the folder, overwrite the DA with
@@ -65,3 +66,22 @@ Tips:
* Press Open-Apple and click on each file in the desired order * Press Open-Apple and click on each file in the desired order
* Select Sort Directory from the Apple menu, and verify the order * Select Sort Directory from the Apple menu, and verify the order
* Restart * Restart
## Package Instructions
To produce a ProDOS disk image with the , install and build the
[Cadius](https://github.com/mach-kernel/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.2mg`
Mount this disk image in your emulator, or transfer it to a real floppy
with [ADTPro](http://adtpro.com/), then follow the last steps of the
install instructions above.