Skip to content

AppleII FujiNet Quickstart Guide

andy diller edited this page Apr 9, 2022 · 30 revisions

Table of Contents

Status of the AppleII FujiNet

April 2022

Currently there is no "Apple2 FN" - you can use boards based on the devkit or you can use an Atari Fujinet 1.0. It must be a 1.0 version (the very first one) due to hardware put into the later boards that while helping the FN work on the Atari, inhibit it working correctly now on the Apple2.

Getting to Know Your FujiNet

(this is future, when an Apple2 FN is released)

  • On the left side of the FujiNet is the power switch; pull it forward for ON and back for OFF (see also Hooking Up FujiNet)
  • The right side has a push/push MicroSD socket.
  • There are 3 status LEDs on top; LEFT is WiFi connection, MIDDLE is BlueTooth connection (BlueTooth is currently inactive in the firmware), RIGHT is network activity status.
  • There are 3 buttons on top; LEFT to be determined, MIDDLE to be determined, RIGHT is FujiNet RESET
  • The back side has two DB19 ports for SmartPort and a MicroUSB port for updating firmware.

Hooking Up FujiNet

  • You will need a BOB - Break out Box - for the Atari FN 1.0. This will get the required pins from the FN. ** (Order a BOB Online)[https://fujinet.online/shop/hardware/sio-pass-through-breakout-board-v2-2/]

You will also need a DB-19 disk adapter - to get those pins into the SmartPort on the Apple. You can get that from the locations below:

FujiNet is powered directly from the Apple2 bus and no external power is required. You can, however, optionally power the FujiNet from the MicroUSB port on the back. If external power is applied, the power switch will not function to turn ON or OFF the FujiNet since power is being supplied directly to the ESP32-DEVKITC module. The MicroUSB port is also used to upgrade firmware and provides debug output messages to a serial monitor on a computer.

Now connect an BMOW DB-19 adapter cable from the FujiNet BOB to a SmartPort on the Apple2 system.

The diagram below shows the pins you need to connect:

The image below shows a clean install from the BOB to the DB-19:

And this shows the use of a bread-board, which is useful as you can also pin out a USB analyser to see what is going on with the port:

The whole system:

Bootup Notes and First Boot

When you turn on the Apple2 with FujiNet connected it may ask to attach a drive. This can happen because the FujiNet is not fast enough to completely boot and be ready before the Apple2 boots. You can do a Ctrl-OA-Reset to reset the Apple2. You can alternatively power the FujiNet from it's MicroUSB port (see Hooking Up FujiNet) and it will always be ready.

Apple IIGS Keyboard tricks:

Keys                               function
-----------------------------------------------------------------
Ctrl-OA-Reset                      Reboot
Ctrl-Shift-OA-Reset                Reboot and re-load BRAM (ROM 03)
Ctrl-OA-OPT-Reset                  System test (OA-OPT to repeat)
Option while power-on              Menu to Reset standards
Ctrl-OPT-Reset                     Reboot and give menu
Ctrl-OA-ESC                        Go to control panel
Ctrl-OA-Shift-ESC                  More direct to control panel
Shift 5 times                      Enable sticky keys (ROM 03 or Sys 6)
Shift-OA-Clear                     Enable keyboard mouse (ROM 03 or Sys 6)
Ctrl-OA-Del                        Clear keybard type-ahead buffer
Hold OA, then Ctrl-Del             Auto fire Button 0
Shift-Period on keypad             Comma
Ctrl-OA-2 in GS/OS desktip app     Select "About.."
Control-6, then <key> in BASIC     Set cursor to <key>
Ctrl-OA-OPT-N  at sliding Apple    Credits
          (i.e "Check Startup" screen)

When you turn on the Apple2 with FujiNet connected it will load the CONFIGuration disk from FujiNet. If it's the first time you booted the FujiNet or if the saved WifI access point is not available you will be prompted to setup a wireless connection. Select your access point and enter it's passphrase.

PLEASE NOTE: FujiNet is powered by the Espressif "ESP32" chipset, which works on 2.4GHz WiFi networks ONLY. If you are using a "mixed" 2.4GHz/5GHz WiFi network (using both radio bands with the same SSID), you MAY have problems connecting your FujiNet device with other devices on the network.

Navigating CONFIG

CONFIG was designed to be intuitive and reminiscent of Apple2 programs like ProDos. On the main CONFIG screen you will see host slots on top and disk slots on bottom. You can jump between the host slots and disk slots with [TAB]. Selecting a host slot ([RETURN]) will begin the process of selecting and mounting a disk image from the host to a disk slot.

Host slots can be an IP address or hostname of a TNFS server (eg, adam-apps.irata.online, fujinet.diller.org). Any host slot can also be named SD which points to the onboard SD card socket. With a host slot selected, press [E] to edit it.

Web User Interface

Your #FujiNet makes available a simple web-based configuration interface when you visit your device's IP address while it's powered on.

To find its IP address, use the [C] "Show Config" option, available in the main screen of the CONFIG program. You can also find the #FujiNet in your router's list of connected devices, by its hostname (default: "FujiNet").

For example, if your #FujiNet's IP address on your local network is "192.168.0.123", you would visit http://192.168.0.123/ in a browser connected to that same network.

Updating Firmware

You can download the FujiNet-Flasher (for Windows, macOS, or Linux), from https://fujinet.online/download/. For more information, see FujiNet-Flasher

Finding and Loading Software

There are some Apple2 disk images at fujinet.diller.org for you to test with.

Currently the Apple2 implementation only works with HDV and PO images, so ensure you have those. More disk image formats for the apple will be added later.

APPLE
.
├── A2OSX.PO
├── APPS
├── GAMES
│ ├── beyond_wolfenstein.po
│ ├── CHOPLIFTER.PO
│ └── DONKEYKONG.PO
├── hello.po
└── IIGS
    ├── DragonsLair.po
    ├── lemmings.hdv
    └── Print_Shop_1987_Broderbund.2mg

Apple Disk Image Formats

There is a lot more here to digest than on the Atari and Adam. Some good links to read are below:

As work continues on the Apple2 CONFIG implementation (led by JeffP) more formats will be supported!

Clone this wiki locally