Skip to content

AppleII FujiNet Quickstart Guide

Jump to bottom Edit New page
andy diller edited this page May 19, 2022 · 30 revisions

Table of Contents

Current Status of the AppleII FujiNet

May 2022

Devkit

Currently there is no "Apple2 FN Device" - you can use boards based on the devkit or you can re-use an existing 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.

Work is being done to verify and get working devkitc boards with appropriate DB-19 connectors for the AppleIIc and GS due to scarcity of FujiNet Rev. 1.0 boards. Currently it looks like the devkit boards have slightly different timings for some reasons and so they do not currently work right out of the box (as of May 19). JeffP is tracking down the issues and will squash them.

In the rest of this doc, I refer to the devices as "FN" but it can be whatever device (devkit, Fujinet) based on the ESP32 you are using to connect.

AutoBooting

  • The AppleIIGS can autoboot currently: just turn it on and with a properly wired and firmware-loaded FN it should load the CONFIG screen.
  • AppleIIc cannot autoboot. To boot it disable the internal drive (by unplugging the drive connector). Then power on the FN and the AppleIIc. Hit CTRL-Reset to get to the ] prompt. Type PR#5 and the FN should load the CONFIG app. After you select a host and load a virtual slot you use ESC to boot. You must again CTRL-Reset and the PR#5 to 'boot' that virtual drive and the disk should load. Check your logs if it doesn't (keep the USB connected and watch the logging output realtime)

Build Notes

  • The current builds should be set to RELEASE to ensure proper timings. To create a Release and also continue to get debug output via the USB ensure these are set in the project:

  • include/debug.h Line 5 should have:

#if defined(__PLATFORMIO_BUILD_DEBUG__) || defined(DBUG2)
  • platformio.ini

*in your env block ensure you have

build_type = release

and in the build_flags ensure there is a line:

    -D DBUG2

The resulting firmware image will be created as a RELEASE and still have all of the debug info over the usb line.

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 need two things to use the FN on the AppleII. Most important is the physical disk port adapter. Usually they are IDC-20 ribbons that go into the DB-19 male adpater that connects to the female port on the back of the Apple. You also need a FN device.

You will one of these

You will need a DB-19 disk adapter - to get those FN pins into the SmartPort on the Apple. You can get adapters from at least the two locations below:

You will need either one of these

A ESP32 Devkitc

Atari FujiNet 1.0 and a BOB - Break out Box - for the Atari FN 1.0. This will get the required pins from the FN.

  • Order a BOB Online
  • Atari FujiNet 1.0 - you must already have one of these or get someone that has one to give to you. They are no longer produced.

Wiring up your Dev FN

FujiNet is powered directly from the AppleII 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.

Atari FN 1.0 and a BOB

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

Warning

  • Be careful wiring up the device. You do not want to connect 12v from the Apple into the FN or you will destroy it.
  • It's critical to find PIN 1 on the IDC-20 - use a tone/continuity device to map PIN1 on the DB-19 to PIN 1 on the IDC-20.
  • What is shown below is just my wiring- some IDC-20 cables are made with the plastic female part flipped 90deg- tone out PIN 1 to be sure.
  • I didn't connect up 5v and just used the USB cable to supply power to my FN

The diagram below shows the pins you need to connect:

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

The whole system:

ESP32

  • Pin up the breadboard and the ESP32 pins to the proper pins on the IDC-20.
  • Ensure you tone out PIN 1 and find which exact pin is PIN 1 on the IDC.

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 available on various tnfs servers:

  • fujinet.diller.org
  • apple-apps.irata.online

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!

Copyright 2024 Contributors to the FujiNetWIFI project.

Join us on Discord: https://discord.gg/7MfFTvD

Clone this wiki locally