Firmware Test Plan for Apple2

Firmware Test Plan for Apple2

All Apple 2 Family computers

Please connect the USB port on the FujiNet to a computer running Windows, MacOS or Linux and launch the FujiNet Flasher application - https://fujinet.online/download/. This will allow you to flash to the newest release and load the Serial diagnostic shell to view the activity log/debug output messages that will be needed for troubleshooting.

Please start with a base/simple system

Apple ][+ = only the 16K language card, SmartPort Card and Drive controller.
Apple //e (all) = only the 64K 80 column card, SmartPort Card and Drive controller.
Apple IIgs = No cards installed and all system slot assignments set to "Your Card" except for Slot 5 (enables the onboard SmartPort drive controller) and Slot 6 (onboard Disk II controller)

Once you have a fully functional base/simple system, then retest your system with each additional card. Remember: if you make two changes at once and something doesn't work then you don't know which change caused the issue. We know this is tedious but it is how a robust system is created.

Apple ][+, //e, //e Enhanced, //e Platinum

Card Installation -

Slot 0 (Apple ][ only) should have the 16K Language card (if you only have a Saturn 128K card then make note of that with any reported errors).

AUX (Apple //e only) should have an Extended 80 Column card w/64K of RAM). If you only have a RAMWorks card, then please make note of that when reporting errors).

Slot 5 should have a SmartPort Card -

• KBOOHK SPROM Card w/ SoftSP v5
• Grappler+ w/ DIY SoftSP v5
• If making your own, you will need a 2732 EPROM and programmer to burn the SoftSP firmware to the EPROM.
• SuperSerial w/ DIY SoftSP v5

Slot 6 Disk Drive interface card -

• Apple Disk II card
• Apple Liron card – Liron has built-in SmartPort therefore, a separate card is not needed.
• Yellowstone card – The Yellowstone card has built-in SmartPort therefore, a separate card is not needed.

Configuration –

First time setup –

1. Power on the Apple II - FujiNet will have its CONFIG disk mounted.
2. Press CTRL-RESET to get a prompt
3. Type PR#X (X=whichever slot your DIY SoftSP ROM card is in, ex: PR#5)
4. Press RETURN
5. The CONFIG disk will boot and display a list of the detected SmartPort devices
6. Press RETURN to continue into CONFIG
7. Follow - https://github.com/FujiNetWIFI/fujinet-platformio/wiki/AppleII-FujiNet-Quickstart-Guide#Navigating-Config for setting up the CONFIG.

Power off the Apple II and FujiNet (remove USB from FujiNet as the FujiNet does not have a power switch)

Testing -

From here we are assuming you are using a SmartPort card and Disk II controller. All the steps are the same if you are using a Liron or Yellowstone card, except you should not need to do the CTRL-RESET followed by PR#5 after each reboot. (NEEDS VERIFICATION)..

Connect the FujiNet to the top IDC20 pin connector of the Disk II card or use a DB19 to IDC20 adapter to connect to the Liron card. The Yellowstone card can use either the top IDC20 or DB19 if you bought the cables from BMOW. Approved adapters are listed on the quick start guide - https://github.com/FujiNetWIFI/fujinet-platformio/wiki/AppleII-FujiNet-Quickstart-Guide.

Plug the USB back into the FujiNet. Make sure your SmartPort card and Drive Controller card are fully seated in the slots and turn on the Apple II.

You should get to the FujiNet boot screen... The screen should clear and be presented with the NAVIGATE screen.

Now perform the following:

1. Arrow down to APPLE-APPS.IRATA.ONLINE and press RETURN
2. Select APPLE_II and press RETURN
3. Select the folder you what - at this time I am using UTILITIES/ and press RETURN
4. Select 2018-01-03 - PRODOS8.2MG and press Return
5. Arrow to number 1 under SMARTPORT DRIVES and press RETURN
6. Press ESC
7. Press TAB to get to the SMARTPORT Drives section
8. 1 should already be highlighted, if not arrow up/down to highlight it and press ESC
9. The screen should clear and a message should appear stating Mounting 1
10. The computer should reboot
11. Press CTRL-RESET
12. Type PR#5 and press RETURN

The computer should load the ProDOS 2.4.1 image and a BITSY BYE menu system should be on the screen.

If this occurred, your system successfully booted to ProDOS 2.4.1

Now every time you reboot, press CTRL-RESET, type PR#5 and it will boot to ProDOS.

To get back to the NAVIGATE screen do the following:

1. Press the Reset button on the FujiNet device (my Rev0 is labeled SAFE RESET with a small S2 next to the button).
2. When you press the FujiNet's reset button the while WiFi light should go off and back on.
3. When the light is back on, reboot the computer (OpenApple-CTRL-RESET, or power cycle).
4. Press CTRL-RESET
5. Type PR#5 and press RETURN

The screen should clear. The boot page should load and clear. Then the NAVIGATE window should appear.

If this all worked. This round of eating is finished. Add your next card to the system and re-test.

Trouble Shooting...

Can your FujiNet connect to WiFi? If no, try the following:

1. Is your Wireless network listed (SSID)?
2. If you SSID is not listed, do you have a 2.4GHz SSID enabled on your network?
3. If you are not broadcasting your SSID, then you will need to manually configure it (DOES THIS WORK???)
4. When you selected your SSID, did you enter the correct password?
5. Anything else?

Once Wireless is working, can you get to the FujiNet web page by using a browser to http:// to the IP address of the FujiNet? If not, try the following:

1. Make sure you are trying to get to the FujiNet web page from the same subnet or have a route/firewall rule to allow traffic to and from this subnet from your wired subnet. Some home networks can be quiet elaborate.
2. Anything else?

If you have a Rev000 or Rev1 card, can you load CP/M? If not, please try the following: (NOTE: Rev0 and Rev00 do not support CP/M)

1. Test 1
2. Test 2
3. Test 3

Once you have a fully working system, please repeat all these steps/tests with the FujiNet unplugged from the USB port. The FujiNet is normally powered directly from the Apple II Bus and therefore no external power should be required. If you find some tests work with USB power but not when only using power from the Bus (or maybe works intermittently) then please report those findings to the FujiNet Discord channel.

Apple //c or //c+

No cards required, but your //c does need to ROM version 0, 3, or 4. The original ROM version is 255, so don’t get confused. To find out your ROM version, type the following at a ] prompt:

PRINT PEEK(64447)

If it returns 255 then you need to get a ROM upgrade. This can be done by downloading and burning your own 32K EPROM, or getting a ROM Xc+.

ROMXc+ - This will let you load any one of 15 different ROM images. Very handing for testing things out. https://www.reactivemicro.com/product/romxc-for-apple-iic-2/

Apple //c ROM images – https://mirrors.apple2.org.za/Apple%20II%20Documentation%20Project/Computers/Apple%20II/Apple%20IIc/ROM%20Images/

Apple IIgs (ROM1 or ROM3)

No SmartPort Card needed as it is built into the IIgs ROMs.

(Work in progress)

Apple /// or ///+

(Work in progress)