FujiNet Setup Guide: Wi-Fi, TNFS Servers and Disk Slots on a Real Atari

An Atari 800XL connected to a monitor showing the FujiNet CONFIG screen with its host list and drive slots

FujiNet is an open-hardware SIO peripheral, created by Thomas Cherryhomes and others from 2019, built around an Espressif ESP32 Wi-Fi/Bluetooth module. Plugged into the Atari's SIO port, it can act as up to eight disk drives, a program recorder, printers and a modem. Its own N: device also gives Atari programs TCP, UDP, HTTP, FTP and TNFS network access. Disk images come from a micro-SD card in the FujiNet, or from TNFS servers on your home network or the Internet.

This guide takes you from unboxing to booting games, then covers the N: device, running your own server, and firmware updates.

You need: any Atari 400/800/XL/XE with an SIO port, a FujiNet, a 2.4 GHz Wi-Fi network, and optionally a FAT32 micro-SD card of 32 GB or less. Even 2 GB is plenty.

1. Know the device

With the SIO plug facing you:

  • Top: buttons A and B on the left, Reset on the right.
  • Left side: USB socket (power and debug serial) and a power switch (up = on).
  • Right side: micro-SD slot, contacts facing you.
  • Front / back: SIO plug to the Atari / SIO socket for daisy-chaining other devices.
  • Lights, left to right: white = Wi-Fi, blue = Bluetooth, orange = SIO activity.
Button Tap Hold
A Disk swap Toggle SIO2BT mode (needs SIO2BT firmware)
B Print debug info to the serial console "Safe reset" (unmounts the SD card first). Held at power-up: reset the FujiNet's configuration
Reset Next Atari boot goes to the CONFIG program instead of the disk in slot 1 —

2. Connect it

  1. Turn off the Atari and the FujiNet. Remove any cartridge, and unplug other SIO devices for this first test.
  2. Plug the FujiNet firmly into the SIO port. Switch it on.
  3. 400/800 owners, or XL/XEs running the 800 OS: power the FujiNet from USB, because it doesn't come up fast enough to answer the Atari's first boot request. If you have no USB supply, the quickstart passes on a tip from Randy Gill: power the 800 while holding START (asking for a cassette boot), wait for the FujiNet to come up, then press RESET.
  4. External USB power also keeps the FujiNet's settings and mounted disks alive between Atari power cycles.

3. First boot and Wi-Fi

  1. Turn on the Atari. The orange light flickers, you hear SIO beeps, and the CONFIG program appears.
  2. Choose your network from the list, or pick Enter a specific SSID. Press Esc to rescan.
  3. Type the password. A Connected to Network screen confirms it, then you reach the host and slot screen.

2.4 GHz only. The ESP32 cannot use 5 GHz. If a router broadcasts one SSID on both bands, you may find you can't ping the FujiNet, reach a TNFS server, or open its web page. The cure is a dedicated 2.4 GHz-only SSID.

Holding SELECT while the Atari boots stops FujiNet from auto-connecting, so you can choose a different network.

4. Using CONFIG

The main screen has two lists of eight entries: TNFS HOST LIST at the top and DRIVE SLOTS at the bottom. Move with the arrow keys (with or without CTRL), a joystick, or keys 1–8. Tab switches lists.

Hosts. Press E to edit a host entry. Type a TNFS server name (for example fujinet.online or apps.irata.online), or SD for the card in the FujiNet. Press Return on a host to browse it.

Browsing. Arrow keys or joystick move through files. Return opens a directory or picks an image. > and < page through the list, Delete/Backspace goes up a directory, and F sets a filter (star* finds Star Raiders, Star Wars, …). N creates a new blank ATR.

Mounting. After you pick an image, choose a drive slot 1–8 (D1:–D8:), then press R (or Return) for read-only or W for read/write. A slot reads, for example, 2 1R /games/Jumpman.atr: from host 2, drive 1, read-only. Select a slot and press E to eject it.

Boot. Press OPTION to reboot into what you mounted. On XL/XE machines, keep holding OPTION as the machine restarts if the software needs BASIC disabled. Mounts persist across reboots. Press the FujiNet's Reset button to get back to CONFIG next time.

Press C for the current configuration: IP address, firmware version, and options to reconnect or change SSID. You can also open the FujiNet's IP address in a desktop browser for its web configuration page. The device's default hostname is FujiNet.

5. Living with other SIO devices

The FujiNet only answers as D1: if nothing else does. So:

  • To boot from a real drive or an SD device, just leave it set as D1:. You can still use FujiNet images in D2: and up, for example a save-game disk on a TNFS server alongside an original game disk.
  • To boot the FujiNet, turn the other D1: off. On an SIO2SD you can set its D1: to "– OFF –".
  • To take the FujiNet out of the picture, use its power switch.

Cartridges. Most cartridges work, and the FujiNet can even serve as the cassette for carts like Delta Drawing. Carts that boot DOS themselves (Atari Logo, the original AtariWriter) can collide with CONFIG in memory. The workaround: power the FujiNet externally, boot CONFIG without the cart and mount what you need, power the Atari off, insert the cartridge, and power on again.

6. The N: device: networking from BASIC

To use the network from your own programs, load the NDEV handler (NDEV.COM from the fnc-tools disk). Usually you rename it as an autorun file: AUTORUN.SYS for DOS 2.5 or DOS XL, AUTORUN.AR0 for MyDOS. The TNFS server apps.irata.online carries DOS disks with it already set up under /Atari_8-Bit/DOS/. Once loaded, it prints FUJINET READY, protects itself at MEMLO and survives RESET.

The devicespec format is N[x]:<PROTO>://<PATH>[:PORT]/. There are units N1:–N4:, and the protocols include TCP, UDP, HTTP, FTP and TNFS. A smoke test from BASIC:

RUN "N:HTTP://FUJINET-TESTING.IRATA.ONLINE/BLACKJACK.BAS"

Setting a directory prefix with XIO 44 (the same call MyDOS and SpartaDOS use to change directory), then saving to your own server:

XIO 44,#1,0,0,"N:TNFS://HOMESERVER/"
SAVE "N:PEWPEW.BAS"

Opening a network file like any other channel:

1010 OPEN #1,12,2,"N:HTTPS://www.gnu.org/licenses/gpl-3.0.txt"

What the errors mean: ERROR- 130 (nonexistent device) means NDEV isn't loaded. ERROR- 138 means you should check that the FujiNet itself is working. The fnc-tools disk also has command-line utilities (NCOPY, NDEL, NREN, NCD, NLOAD) that talk to the FujiNet directly over SIO, so they work without NDEV.

7. Run your own TNFS server

TNFS (Tiny Network File System) was created by Dylan Smith around 2010 for the ZX Spectrum's Spectranet interface. FujiNet uses an updated fork of its server, tnfsd. It uses UDP port 16384, and now also TCP with UDP fallback. Pre-built binaries for Windows, Linux, Raspberry Pi and macOS are on fujinet.online's download page.

Windows, the manual way: put tnfsd.exe in C:\tnfsd, make a share folder C:\tnfsroot, and allow tnfsd.exe through the Windows Firewall. Then create a Task Scheduler task that runs C:\tnfsd\tnfsd.exe C:\tnfsroot at startup. The Tnfsd.NET utility automates this. Afterwards, it's wise to run it under a user with read-only access to the folder.

Linux:

git clone https://github.com/FujiNetWIFI/tnfsd.git
cd tnfsd/src
make OS=LINUX DEBUG=Y
sudo cp ../bin/tnfsd /usr/local/sbin
tnfsd /path/to/atari/images

The FujiNet wiki also has a systemd unit and a Samba share setup for the folder. There is an AUR package for Arch (yay -S tnfsd) and a ready-made Raspberry Pi image. Then add your server's IP address or hostname as a host in CONFIG.

Public servers come and go. Known public servers include fujinet.online, fujinet.pl, atari-apps.irata.online, tnfs.fujinet.systems, fujinet.atari8bit.net and others, and atari8bit.net keeps a server-status page.

8. Firmware updates

Use FujiNet-Flasher from fujinet.online/download (Windows, macOS, Linux). Connect the FujiNet by USB, pick the platform and firmware version, and click Flash. Run it as administrator on Windows. On Linux, run it as root or add yourself to the serial device's group (sudo usermod -a -G dialout USERNAME). If your PC doesn't see the device, install the Silicon Labs USB-to-UART driver. The flasher only supports Atari FujiNets with 8 MB PSRAM and 16 MB flash.

Troubleshooting

  • Flasher stuck on "Connecting…": try another USB cable, which is often the culprit. Otherwise hold button A for the whole flash, or start the flash right after plugging in, before another program grabs the port.
  • Atari boots straight past FujiNet: another device is answering as D1:, or (on a 400/800) the FujiNet wasn't powered in time.
  • Can't reach a server: check you're on 2.4 GHz, check the IP address under [C]onfig, and make sure your firewall lets UDP 16384 through to tnfsd.
  • Debug log needed: in FujiNet-Flasher, choose the port, click Serial Debug Output, and press the FujiNet's Reset button.
  • No hardware yet? FujiNet-PC plus a NetSIO bridge lets Altirra (via a netsio.atdevice custom device) talk to a software FujiNet. The wiki's Run FujiNet with Altirra page walks through it, including two linked instances.

Further reading

  • The FujiNet wiki's CONFIG Users Guide, Using the N: Device and N: Game Developer Cheat Sheet.
  • The comp.sys.atari.8bit FAQ, sections 3.2.8, 3.4.2 and 5.4.3.
  • Our guides to SIO2PC/RespeQt and SD and flash devices.

Credits