Apple-2-SW
/
rom4x
mirror of https://github.com/mgcaret/rom4x.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity
Improved Apple //c (ROM 4X) and Apple IIc Plus (ROM 5X) firmware.
97 Commits 7 Branches 6 Tags 190 KiB
Assembly 88.7%
Ruby 8.9%
Objective-C 1.6%
Shell 0.4%
C 0.4%
Go to file
mgcaret 55c9a71e0d
mention XModem feature 		2018-10-17 14:47:04 -07:00
notes 5X: the Merlin fix 2017-12-10 18:01:37 -08:00
rom4x caveat regarding receiver memory 2018-10-15 15:53:58 -07:00
rom5x Clean up README.md some more for ROM 5X. 2018-08-02 14:16:21 -07:00
.gitignore Add patch to make delete key work like backspace in monitor GETLN/GETLN1 2017-10-11 12:38:29 -07:00
README.md mention XModem feature 2018-10-17 14:47:04 -07:00
dist.sh modify dist.sh 2018-09-29 15:51:50 -07:00
story.md reorganize documentation 2017-10-02 12:27:09 -07:00

README.md

ROM 4X and 5X by MG

ROM 4X and 5X are enhancements to the Apple //c version 4 and Apple IIc Plus firmware ROMs.

It adds the following features to the Apple //c and IIc Plus firmware:

  • Identifies and reinstates a bootable (it must have something that looks like a boot block!) RAM disk from battery-backed expansion memory (see below), such as the RAM Express II+ from A2Heaven.
  • Provides a menu of various tools upon pressing Ctrl+Closed-Apple+Reset (or holding Closed-Apple when powering up), that let you:
    • Enter the monitor unconditionally.
    • Reboot the machine (enter standard boot sequence).
    • Zero the RAM card, in case it is corrupted.
    • Execute the machine and RAM card diagnostics.
    • Tell the machine to boot the SmartPort, the internal floppy drive, or an external floppy drive.
  • IIc only:
    • The system drops to BASIC if no bootable device is found (this is the default behavior in the IIc Plus).
    • Configure default boot device by saving a file on the RAM Disk.
    • XModem-CRC support.
  • IIc Plus only:
    • Menu control the built-in accelerator.
    • Accelerator settings persist across resets.
    • Build option to default the system to 1 MHz.

The first feature listed above is the raison d'etre for this project. The larger story is down below but in short: The Apple //c memory card driver keeps certain information in the "screen holes" in main memory, which are required to use the memory card as a RAM disk. Should these screen hole values disappear, the card is re-initialized to empty when ProDOS boots. This happens even when the card is battery-backed and already has a RAM disk. The card data is not damaged until ProDOS boots, but if you attempt to manually boot the RAM disk it will say "UNABLE TO START FROM MEMORY CARD" because the screen hole values are not initialized.

This firmware enhancement identifies a ProDOS boot block on the RAM disk and, if found, restores the appropriate screen holes to make the RAM disk bootable and prevent firmware or ProDOS from re-initializing it.

Build / Install / Documentation

ROM 4X

See the ROM 4X README.md.

ROM 5X

See the ROM 5X README.md.

The Whole Story

Why did I do this? See story.md.