====== Updated AppleShare Apple II Boot Blocks ======

AppleShare Apple II Boot Blocks are used by the Apple IIgs, Apple II Workstation Card, and the Apple %%//%%e Card for Macintosh LC to initiate a network boot. For the IIgs and Workstation Card, it is a true network boot and the boot blocks are downloaded from the server.  The Apple %%//%%e Card loads them from its application file instead.

The purpose of the Apple %%//%%e boot blocks are to install ProDOS in memory, initialize AppleTalk, and allow the user to logon to a file server.  Ultimately, the end result is that the system achieves a diskless startup. The IIgs boot blocks are similar, but include a first-stage boot loader that loads a second stage (which is what we are concerned with) that includes the second stage code itself ("Fizzy") as well as several embedded files for setting up AppleTalk higher-level protocols and selectively booting ProDOS 8 or GS/OS.

These AppleShare Apple %%//%%e boot blocks use the latest version of the logon program and are available with ProDOS 2.0.3 (the last official release from Apple) or ProDOS 2.4.x by John Brooks.

ProDOS 2.4.1 has been patched to work around bugs in Bitsy Bye related to the Apple %%//%%e Card for Macintosh LC.  Note that [[http://www.callapple.org/vintage-apple-computers/apple-ii/announcing-prodos-2-4-2-for-all-apple-ii-computers/|ProDOS 2.4.2]] includes these fixes.

For more information on setting up AppleShare/NetAtalk, see {{https://peterwong.net/blog/apple-iigs-network-netatalk/|Peter Wong's excellent page}} on the topic.

===== For AppleShare Server and Netatalk =====

**Apple %%//%%e**

  * {{ :projects:iie.bootblks.203.gz |Boot Blocks with ProDOS 2.0.3}}
  * {{ :projects:iie.bootblks.241.gz |Boot Blocks with ProDOS 2.4.1}} //outdated//
  * {{ :projects:iie.bootblks.242.gz |Boot Blocks with ProDOS 2.4.2}}

**Apple IIgs** //experimental//

Normally, the Apple IIgs reads the Boot OS (ProDOS 8 or GS/OS) selection from the battery RAM (BRAM).  The following boot blocks have been modified to allow overriding the BRAM selection by two methods: Press ''8'' or ''G'' before the "Starting Up Over the Network" message appears to select ProDOS 8 or GS/OS respectively, or modify the ''ProDOS16 Image'' file at $0204 to have 0 for firmware decides (default), 1 for GS/OS, and 2 for ProDOS 8.

  * {{ :projects:prodos16_image.203.mgfizzy.gz |Apple IIgs GS/OS Boot Blocks with ProDOS 2.0.3 and Selection Override}} //Tested Working//
  * {{ :projects:prodos16_image.203.mgfizzy.bridgefix.gz |Apple IIgs GS/OS Boot Blocks with ProDOS 2.0.3 and Selection Override, and Geoff Body's EtherTalk Bridge Fix}}
    * This will allow booting to ProDOS 8 without having the machine freeze.
    * Geoff's ''ATALKIRQ'' PIF is not required and should not be installed if this image is used.
    * For more information, see {{http://appleii.ivanx.com/a2server/scripts/a2server-5-netboot.txt|here}}.

Note that ProDOS 2.4.x seems to have trouble being part of the GS/OS boot blocks and crashes to the monitor.


==== Installation ====

=== Netatalk ===

This assumes you already have Netatalk with Apple II boot working.

Download the boot blocks file, expand with gunzip, and copy to the a2boot subdirectory of the netatalk config directory.   Name the %%//%%e file ''Apple :2f:2fe Boot Blocks'' and the IIgs file ''ProDOS16 Image''.  You probably want to back up your existing files first.

=== AppleShare Server ===

I don't personally run this so it is untested, but you will likely need to change the type and creator after finding a way to get the expanded file onto your Macintosh.  The files will need to be named ''Apple %%//%%e Boot Blocks'' and ''ProDOS16 Image'' and you should back up your existing files.

===== For Apple //e Card for Macintosh LC =====

  * {{ :projects:bblk.203.mac.bin |Boot Blocks with ProDOS 2.0.3}}
  * {{ :projects:bblk.241.mac.bin |Boot Blocks with ProDOS 2.4.1}} //outdated//
  * {{ :projects:bblk.242.mac.bin |Boot Blocks with ProDOS 2.4.2}}

Also, see [[projects:netboot_lc|NetBoot LC]] for an alternative to updating boot blocks in the ''IIe Startup'' application.
==== Installation ====

  - Download the boot blocks to your Macintosh.
  - Decode the Macbinary file.  The resulting file will look like an application, but it is not and clicking it will do nothing.
  - Open both the decoded file and a **copy** of ''IIe Startup'' in ResEdit.
  - Open the ''BBLK'' resources in the copy of ''IIe Startup'', there should be one resource with ID 5120.
  - Delete ''BBLK'' ID 5120.
  - Open the ''BBLK'' resources in the decoded file.
  - Copy ID 5120 from the decoded file to the ''BBLK'' resources in the copy of ''IIe Startup''.
  - Quit ResEdit, save the copy of ''IIe Startup'' on your way out.