Wiki Home >> ADAM-FujiNet-Quickstart-Guide

ADAM-FujiNet-Quickstart-Guide


FujiNet CONFIG Set-Up Guide for the Coleco ADAM

Easy-to-follow instructions on setting up and using FujiNet CONFIG with your ADAM Family Computer System. Written for first-time FujiNet users — no networking experience required.

FujiNet for the Coleco ADAM


Contents

  1. What Is FujiNet?
  2. What You Need
  3. Know Your FujiNet
  4. Hooking Up Your FujiNet
  5. Turning On Your Computer
  6. Connecting to Your Wireless Network
  7. The Main Screen: Hosts and Disk Slots
  8. Browsing a Host
  9. Mounting a Disk Image
  10. Booting Your Software
  11. Creating a New Disk Image
  12. Copying Files Between Hosts
  13. The Configuration Screen
  14. Using Your Game Controllers
  15. Returning to CONFIG
  16. Troubleshooting
  17. Key Reference Charts
  18. Glossary
  19. Learning More

What Is FujiNet?

FujiNet is a wireless network adapter and multi-peripheral for your Coleco ADAM. It
plugs into the ADAMnet bus — the same connection used by your ADAM's keyboard and
disk drives — and gives your ADAM:

  • Four virtual disk drives. FujiNet appears to the ADAM as ADAMnet disk drives.
    Disk images (software stored as files) can be loaded — "mounted" — into any of
    four disk slots and used as if they were real Digital Data Packs or floppy disks.
  • Access to file servers on the Internet. Public servers (called TNFS hosts)
    offer entire libraries of ADAM software you can browse and boot in seconds.
  • A microSD card slot. Your own library, on a card in the FujiNet itself.
  • A virtual printer. FujiNet can stand in for the ADAM printer and capture
    print output for retrieval from its built-in web page.
  • Network devices for programs. ADAM software written for FujiNet can reach
    the Internet through it (the N: network device).

CONFIG is the program you use to manage all of this. It is stored inside the
FujiNet itself, and the ADAM boots it automatically. CONFIG is what this guide
teaches: every screen, every key, every function.

What You Need

Before you begin, make sure you have everything:

  • Your ADAM Family Computer System (or Expansion Module #3), hooked up and working
  • A FujiNet for the Coleco ADAM
  • An ADAMnet cable (RJ12 6P6C — supplied with most FujiNets)
  • A 2.4 GHz Wi-Fi network and its password. FujiNet's radio supports 802.11 b/g/n
    on 2.4 GHz only; a 5 GHz-only network will not be seen.
  • (Optional) A microSD card, formatted FAT32

Know Your FujiNet

Parts of the ADAM FujiNet

PartWhat it does
ADAMNET IN jack (RJ12)Connects to the ADAM's ADAMnet port
ADAMNET OUT jack (RJ12)Pass-through, so other ADAMnet devices can daisy-chain behind FujiNet
microSD slotHolds an optional FAT32-formatted card with your disk images
Power switchTurns the FujiNet on and off
WiFi LED (white)Lit when FujiNet is connected to your wireless network
BT LED (blue)Lit when Bluetooth mode is active
Bus LED (orange)Flickers with ADAMnet activity
Button AShort press: rotates the mounted disk images between slots (disk swap)
Button BHold for a few seconds: restarts the FujiNet
Safe Reset buttonShort press: safely restarts the FujiNet
micro-USB portPower/programming connector on the ESP32 module; used for firmware flashing

Hooking Up Your FujiNet

  1. Turn your ADAM off.
  2. Plug one end of the ADAMnet cable into the jack marked ADAMNET IN on the
    FujiNet.
  3. Plug the other end into the ADAMnet port on your ADAM.
  4. If you had another ADAMnet device plugged into that port, plug it into the
    FujiNet's ADAMNET OUT jack — devices behind FujiNet keep working normally.
  5. If you have a microSD card, insert it into the card slot until it clicks.
  6. Slide the FujiNet's power switch to ON.

Hooking up

Turning On Your Computer

  1. Make sure there is no Digital Data Pack in your data drive and no disk in
    your disk drive, and no game cartridge in the cartridge slot.
  2. Turn on your TV and select the proper channel.
  3. Turn on the ADAM (the switch on the back of the SmartWRITER printer) — or, if
    it is already on, pull the COMPUTER RESET switch toward you.
  4. The ADAM boots from the FujiNet, and after a moment you will hear a cheerful
    chime and see WELCOME TO FUJINET at the bottom of the screen.

CONFIG lives inside the FujiNet and acts as the ADAM's boot device whenever the
FujiNet has just been switched on. You never need to load it from a digital
data pack or disk.

NOTE: If a disk image is already mounted in disk slot 1 from a previous
session, the ADAM boots that software instead. See
Returning to CONFIG.

Connecting to Your Wireless Network

The first time FujiNet starts (and any time it has no stored network), CONFIG
goes straight into network setup. If your FujiNet is already connected, CONFIG
skips ahead to the main screen, and you can skip ahead too.

About the SmartKeys

CONFIG is operated mostly with the ADAM's six SmartKeys — the dark keys
numbered I through VI across the top of the keyboard. The bottom of every
CONFIG screen shows a row of labeled boxes; each box lines up with one SmartKey.
If a box is blank, that SmartKey does nothing on the current screen. This guide
writes them as [ I ] through [ VI ].

Scanning and selecting

When network setup begins you will see SCANNING FOR NETWORKS... and then a
list of the wireless networks FujiNet found (up to 16):

Network scan screen

  • Your FujiNet's MAC address is printed at the top of the screen — useful if
    your router filters devices.
  • Each network shows a one-to-three bar signal-strength meter. More bars,
    better signal.
  • The status area reads N NETWORKS FOUND — SELECT A NETWORK.
KeyAction
↑ / ↓Move the highlight bar
RETURNChoose the highlighted network
[ IV ] HIDDEN SSIDType the name of a network that doesn't broadcast itself
[ V ] RESCANSearch for networks again
[ VI ] SKIPSkip network setup and go to the main screen without a connection

Entering your password

After you choose a network, CONFIG asks: ENTER NETWORK PASSWORD AND PRESS
[RETURN]
. Type the password (up to 64 characters — capitalization matters) and
press RETURN. Each character appears as a smudge so onlookers can't read your
password. Use BACKSPACE to fix mistakes.

If you chose HIDDEN SSID, you'll first be asked to type the network's name
(up to 32 characters), then the password.

Password entry

Connecting

CONFIG announces CONNECTING TO NETWORK with the network's name, and tries for
about 20 attempts, displaying PLEASE WAIT...(ESC TO ABORT). Then:

  • CONNECTION SUCCESS! — you're online. CONFIG remembers this network inside
    the FujiNet and will reconnect automatically every time it powers up. You go
    straight to the main screen.
  • CONNECT FAILED, NO SSID AVAILABLE, CONNECTION LOST, or UNABLE TO
    CONNECT
    — the connection didn't take; CONFIG returns to the network list.
    Most often the password was mistyped — try again. See
    Troubleshooting.
  • Press ESCAPE/WP at any time to abort the attempt.

The Main Screen: Hosts and Disk Slots

This is CONFIG's home screen, and the one you'll use most. It has two halves:

Hosts and devices screen

  • HOST SLOTS — eight remembered places software can come from. A host is
    most often a TNFS server on the Internet (such as fujinet.online) or
    the FujiNet's own SD card (enter the name SD) — but several other
    server types work too; see the protocol table below. Empty slots read
    EMPTY.
  • DISK SLOTS — the four virtual drives the ADAM sees. Each shows the disk
    image currently mounted in it, or EMPTY (nothing mounted), or OFF
    (that virtual drive is disabled).

Press TAB to jump back and forth between the two halves. The bottom of the
screen always lists the active keys.

Working with host slots

KeyAction
↑ / ↓Move the highlight bar
1–8Jump straight to a host slot
RETURNOpen the highlighted host and browse it (next section)
TABSwitch to the disk slots
[ IV ] SHOW CONFIGShow FujiNet's network details (Configuration Screen)
[ V ] EDIT SLOTType a new host name into the highlighted slot
[ VI ] BOOTLeave CONFIG and boot the ADAM with whatever is mounted

To add a host: highlight a slot, press [ V ] EDIT SLOT, type the host
name, and press RETURN.

Host slots speak several protocols. What you type determines what FujiNet
connects to:

You typeFujiNet connects to
SDThe microSD card inside your FujiNet
A plain name or IP address (e.g. fujinet.online)A TNFS server — the default when no protocol is given
http://server/path or https://server/pathA web server. FujiNet reads the server's index page and presents it as a browsable folder (works with most auto-generated directory listings)
smb://server/shareA Windows file share (SMB). Credentials may be included: smb://user:password@server/share
nfs://server/exportAn NFS server
ftp://serverAn FTP server

Some names to try first: SD, fujinet.online, or the name/IP of a TNFS
server running on your own PC.

Editing a host slot

To clear a host: edit the slot and backspace the name away, then press
RETURN.

IMPORTANT: Changing or clearing a host slot automatically ejects any disk
images that were mounted from it, since they can no longer be reached.

Working with disk slots

Press TAB to move to the DISK SLOTS half:

Disk slots

KeyAction
↑ / ↓Move the highlight bar
1–4Jump straight to a disk slot
TABSwitch back to the host slots
[ IV ] EJECTUnmount the image in the highlighted slot
[ V ] ON/OFF TOGGLEEnable or disable that virtual drive entirely
[ VI ] BOOTLeave CONFIG and boot with the current arrangement
CLEAREject all disk slots at once

Each slot's number is drawn on a colored tile: blue means the image is
mounted read-only, green means read/write.

ON/OFF TOGGLE is for owners of real hardware: if you have a physical disk
drive or digital data drive at the same ADAMnet address, switch the corresponding FujiNet slot
OFF so the two don't collide. A slot showing OFF ignores everything until
toggled back on.

If a mounted image's filename is too long for the slot row, the full name is
shown in the area below the disk slots.

Browsing a Host

Highlight a host slot and press RETURN. CONFIG shows OPENING... and then
lists the host's files:

File browser

The host's name and your current folder path are shown at the top. Each entry
carries a small icon showing what it is — a folder, a DDP (Digital Data Pack
image), a DSK (disk image), or a ROM. Fifteen entries are listed per page; a
[...] mark at the top or bottom of the list means there is more in that
direction.

KeyAction
↑ / ↓Move the highlight bar (keeps going onto the next/previous page)
CONTROL + ↑ / ↓Jump a whole page at a time
HOMEGo back to the top of the list
RETURNOpen the highlighted folder, or pick the highlighted file
[ IV ] UPGo up to the parent folder (hidden when you're at the top)
[ V ] FILTERShow only matching files / search the whole host (below)
[ VI ] BOOT / QUICK BOOTInstantly mount the highlighted file in slot 1 and boot it
INSERTCreate a brand-new blank disk image (details)
MOVE/COPYCopy the highlighted file to another host (details)
ESCAPE/WPAbort and return to the main screen

Names too long for the list are shown in full at the bottom of the screen when
you rest the highlight on them for a moment.

Filtering and searching

Press [ V ] FILTER and CONFIG prompts: ENTER A WILDCARD FILTER. E.G.
*Coleco*, or !TERM FOR SEARCH.

  • A pattern with * wildcards — like *Coleco* or Donkey* — narrows the
    current folder to matching names.
  • A pattern starting with ! — like !zorksearches the entire host, top
    to bottom, and lists every file whose name contains that term, wherever it is.
  • Enter a blank filter to see everything again.

While a filter is active it is displayed in the top-right corner of the browser.

On some public servers you may see entries marked with a +. These are links to
other TNFS hosts. Choosing one connects you to the linked host and continues
browsing there. (The linked host's name is written into host slot 8, so it also
appears on your main screen afterward.)

Mounting a Disk Image

Highlight a disk image in the browser and press RETURN. CONFIG shows the
FILE DETAILS screen: the file's name, date, and size, along with your four
disk slots:

Select slot

KeyAction
↑ / ↓ or 1–4Choose a disk slot
RETURN or [ V ] READ ONLYMount the image read-only (safe — the image cannot be changed)
[ VI ] READ/WRITEMount the image writable, so programs can save onto it
[ IV ] EJECTEmpty the highlighted slot first, if you need room
ESCAPE/WPAbort, back to the main screen

After mounting, CONFIG returns you to the browser in the same folder so you can
mount additional disks into other slots. Press ESCAPE/WP when you're done to
go back to the main screen.

HINT: Mount read-only unless you know the software saves to its own disk.
Read-only images can be shared by everyone on a server simultaneously, and a
stray write can never damage them.

Booting Your Software

There are two ways to start the software you've mounted:

  1. BOOT — from the main screen (either half), press [ VI ] BOOT. CONFIG
    mounts everything listed in your disk slots, disables itself, and restarts
    the ADAM. The ADAM boots from disk slot 1 exactly as if a real Data Pack were
    in the drive.
  2. QUICK BOOT — in the browser, highlight a disk image and press [ VI ].
    The image is mounted into disk slot 1 (read-only) and booted immediately —
    browse, pick, play.

Your mounted disk slots are remembered inside the FujiNet, so the same software
boots again next time — until you eject it or mount something else.

Creating a New Disk Image

CONFIG can manufacture blank media on any writable host — your SD card or a
TNFS server that allows writing. While browsing the folder where you want the
new image, press INSERT:

  1. SELECT MEDIA TYPE — press [ V ] DDP for a Digital Data Pack image, or
    [ VI ] DISK for a floppy disk image. (Any other key cancels.)
  2. SIZE? — pick a capacity with the SmartKeys:

    • DDP: 128K, 256K, or 320K — or CUSTOM
    • DISK: 160K, 320K, 720K, or 1440K — or CUSTOM
    • CUSTOM asks for the size as a number of 1K blocks.

    NOTE: 256K is the most common DDP size — it is the size of a
    standard digital data pack. 160K is the most common DSK size — the size
    of a standard Coleco Disk Drive disk.

  3. PLEASE ENTER A FILENAME FOR THIS DISK/DDP: — type a name (give it a
    .ddp or .dsk ending to match its type) and press RETURN. A blank name
    cancels.
  4. Choose which disk slot to put it in, and press RETURN. CONFIG shows
    CREATING FILE... PLEASE WAIT. The new image is mounted read/write.
  5. DO YOU WISH TO WRITE AN EOS DIRECTORY TO THIS IMAGE? — press [ V ] YES
    to format the image for EOS (SmartBASIC, SmartWriter and friends), or
    [ VI ] NO to leave it completely blank (for CP/M or other uses).
  6. If you chose YES: ENTER A VOLUME LABEL (12 CHARACTERS MAX), type a name
    for the volume, and press RETURN. CONFIG writes the directory —
    CREATING THE DIRECTORY. PLEASE WAIT.

Creating new media

You then return to the main screen with your fresh, formatted, writable disk
ready in its slot.

Copying Files Between Hosts

CONFIG can copy a file from any host to any writable host — TNFS server to SD
card, SD to TNFS, even server to server. Grab a game from fujinet.online and
keep it on your own card:

  1. Browse to the file you want and highlight it.
  2. Press the MOVE/COPY key. (The original is never altered.)
  3. COPY TO HOST SLOT — your eight host slots are listed. Choose the
    destination host with 1–8 or the arrows, and press RETURN.
    (ESCAPE/WP aborts.)
  4. The destination host opens in the browser. Walk to the folder where the copy
    should go. The status line reads SELECT DESTINATION.
  5. Press [ VI ] PERFORM COPY. CONFIG shows COPYING FILE...PLEASE WAIT.
    with the source and destination paths.

Copying a file

When the copy finishes you are returned to the folder you copied from.

The Configuration Screen

From the main screen's host half, press [ IV ] SHOW CONFIG:

Configuration screen

FieldMeaning
SSIDThe wireless network FujiNet is connected to
HOSTNAMEFujiNet's name on your network
IPFujiNet's address on your network
NETMASKYour network's subnet mask
DNSThe name server FujiNet uses
MACFujiNet's hardware address
BSSIDThe hardware address of your Wi-Fi access point
FNVERThe FujiNet firmware version and build date
KeyAction
[ IV ] PRINTER? YES/NOToggle FujiNet's virtual printer
[ V ] CHANGE SSIDForget this network and run network setup again
[ VI ] RECONNECTDrop and re-join the current network
RETURN / ESCAPE / SPACEBack to the main screen

About the printer toggle: when set to YES, FujiNet answers as the ADAM's
ADAMnet printer and quietly captures everything programs print; you can view and
save the output from FujiNet's built-in web page. Set it to NO if you want
output to go to the real SmartWRITER printer instead.

The web page: type the IP address shown here into a web browser on any
computer or phone on your network (for example http://192.168.1.123/) to reach
FujiNet's full configuration site — printer output, host and slot management,
firmware settings, and more.

Using Your Game Controllers

Just like the ADAM's keypad controllers can drive SmartWriter, they can drive
CONFIG — from the comfort of your couch:

ControlAction
Joystick up / down (hold briefly)Move the highlight bar
Either fire buttonSame as RETURN
Keypad 1–8Jump to that slot
Keypad ✱Same as [ VI ] — BOOT

Both controller ports work.

Returning to CONFIG

After you press BOOT, CONFIG steps out of the way until the FujiNet is restarted.
To get back to CONFIG:

  1. Press the FujiNet's Safe Reset button (or switch it off and on).
  2. Pull the ADAM's COMPUTER RESET switch.

The ADAM boots into CONFIG again, with your hosts and mounted images just as you
left them.

Swapping disks without CONFIG: when software asks you to "insert disk 2,"
press FujiNet's Button A. Each short press rotates the mounted images one
slot forward — slot 2's image moves into slot 1, and so on, all without leaving
your program.

Troubleshooting

SymptomCauseRemedy
ADAM boots SmartWriter, not CONFIGFujiNet off, or cable looseCheck power switch and ADAMnet cable; pull COMPUTER RESET
Boot media in a driveRemove Data Packs/disks and reset
ADAM boots old software instead of CONFIGAn image is still mounted in slot 1Restart FujiNet, then pull COMPUTER RESET; or eject via the web page
No networks found2.4 GHz network not in rangeFujiNet sees 2.4 GHz networks only; move closer, or check the router broadcasts on 2.4 GHz
Network is hiddenUse [ IV ] HIDDEN SSID and type the name
CONNECT FAILED / UNABLE TO CONNECTWrong passwordRe-enter carefully — capitalization counts
Router restrictionsCheck MAC filtering against the MAC shown on the scan screen
COULD NOT MOUNT HOST SLOTHost name mistyped, server down, or no SD cardCheck spelling with EDIT SLOT; confirm the server is reachable; insert/format the SD card (FAT32)
COULD NOT OPEN DIRECTORYPath or filter problemPress HOME, clear the filter, try again
ERROR SETTING DISK MODE / can't mount READ/WRITEHost or image is read-onlyPublic servers are usually read-only; copy the image to SD first
Printer output vanishesFujiNet printer set to YESView captured output on the web page, or set PRINTER? to NO
Real disk drive or digital data drive conflicts with FujiNetBoth answer the same ADAMnet drive numberSwitch the matching disk slot OFF with [ V ] ON/OFF TOGGLE

Key Reference Charts

Network selection screen

KeyFunction
↑ / ↓Move highlight
RETURNSelect network
[ IV ]Enter hidden SSID by name
[ V ]Rescan
[ VI ]Skip network setup
ESCAPE/WP (while connecting)Abort connection attempt

Main screen — host slots

KeyFunction
↑ / ↓, 1–8Move / jump
RETURNBrowse highlighted host
TABTo disk slots
[ IV ]Show configuration
[ V ]Edit host slot
[ VI ]Boot

Main screen — disk slots

KeyFunction
↑ / ↓, 1–4Move / jump
TABTo host slots
CLEAREject all slots
[ IV ]Eject slot
[ V ]Drive on/off toggle
[ VI ]Boot

File browser

KeyFunction
↑ / ↓Move highlight (auto-pages)
CONTROL + ↑ / ↓Page up / page down
HOMETop of list
RETURNOpen folder / choose file
INSERTCreate new image
MOVE/COPYCopy file to another host
[ IV ]Up one folder
[ V ]Filter / search
[ VI ]Boot highlighted image now
ESCAPE/WPBack to main screen

Mounting (FILE DETAILS) screen

KeyFunction
↑ / ↓, 1–4Choose slot
RETURN or [ V ]Mount read-only
[ VI ]Mount read/write
[ IV ]Eject slot
ESCAPE/WPAbort

Configuration screen

KeyFunction
[ IV ]Printer on/off
[ V ]Change network
[ VI ]Reconnect
RETURN / ESCAPE / SPACEBack

Glossary

  • ADAMnet — the ADAM's built-in network of peripherals (keyboard, drives,
    printer). FujiNet joins it as several devices at once.
  • CONFIG — the program in this guide; FujiNet's control panel, booted by the
    ADAM directly from the FujiNet.
  • DDP — a Digital Data Pack image file; an entire ADAM digital data pack
    in a single file.
  • Disk image — a complete digital data pack or disk stored as one file
    (.ddp, .dsk, .rom).
  • Disk slot — one of FujiNet's four virtual drives. What is mounted in disk
    slot 1 is what the ADAM boots.
  • EOS — the Elementary Operating System, the ADAM's native OS. "Writing an
    EOS directory" is formatting an image so EOS programs can store files on it.
  • FTP — the File Transfer Protocol, a longtime Internet standard for
    moving files. A host slot beginning ftp:// browses an FTP server.
  • Host — a place disk images live: a TNFS, web (HTTP/HTTPS), SMB, NFS,
    or FTP server — or FujiNet's SD card.
  • Host slot — one of eight remembered host names on the main screen.
  • HTTP — the protocol of the World Wide Web. A host slot beginning
    http:// or https:// reads a web server's index page and presents it as
    a browsable folder.
  • MAC address — a hardware serial number that identifies FujiNet to your
    network.
  • Mount — to load a disk image into a disk slot, like inserting a
    digital data pack.
  • NFS — the Network File System, a file-sharing protocol commonly used on
    UNIX™ systems. A host slot beginning nfs:// browses an NFS server's
    export.
  • Read-only / Read-write — whether programs may change the mounted image.
  • SMB — Server Message Block, the file-sharing protocol of Microsoft
    Windows. A host slot beginning smb:// browses a Windows shared folder.
  • SSID — the broadcast name of a wireless network.
  • TNFS — Trivial Network File System, the simple protocol FujiNet uses to
    browse Internet software servers.

Learning More


FujiNet is an open-source community project. ADAM, SmartWRITER, SmartBASIC,
ColecoVision and UNIX are trademarks of their respective owners; they are used
here in loving tribute.


Wiki content is mirrored from the FujiNet Github Wiki