Skip to content

FujiNet Flasher

Jump to bottom Edit New page
mozzwald edited this page Feb 28, 2022 · 19 revisions

Table of Contents

Overview

Occasionally, new versions of the #FujiNet firmware (the software that runs on the #FujiNet device itself) are released. The main #FujiNet website has a page dedicated to the "FujiNet Flasher" tool, located here: https://fujinet.online/download/

On that page, you can:

  • see what the latest version is, which you can compare to the version your #FujiNet device is currently running,
    • shown on your #FujiNet's web interface ("FujiNet Version", at the top of the "Network" section), or
    • shown when you press the [C] key in the CONFIG tool running on your Atari
    • (e.g., 0.5.ce7a9391 was the version released on 2020-11-14)
  • view all of the Git software repository commits (new changes, bug fixes, etc.) that were added in the most recent version
  • download the flasher software (a Python-based graphical (GUI) application; source available here: https://github.com/FujiNetWIFI/fujinet-flasher), for (as of Nov. 2020)
    • for Windows x86 & x64
    • MacOS Catalina 10.15
    • Linux x64
  • if you need to, manually download the latest firmware releases (from https://fujinet.online/firmware-dl/)
  • and more!

How to find out when a new version is available?

Install the USB Driver

Some computers may not detect the FujiNet when it is plugged in. You may need to install the USB to UART driver from [Silicon Labs][https://www.silabs.com/products/development-tools/software/usb-to-uart-bridge-vcp-drivers] (manufacturer of the chip used in Fujinet). Download and install the appropriate driver for your system.

Installing Firmware with FujiNet Flasher

The FujiNet Flasher tool will download the latest firmware, and upload it to your #FujiNet device.

Note: The flash tool only supports #FujiNet hardware with 8MB PSRAM and 16MB flash.

Windows

Run with administrator privileges

macOS

(Details needed.)

Linux

Run as root, e.g. sudo ./FujiNet-Flasher. Alternatively, add your 'regular' user to the appropriate 'group' on your system. For example, if your #FujiNet, via micro-USB cable, appears on your system as the device /dev/ttyUSB0, check which group the device is part of.

ls -l /dev/ttyUSB0
crw-rw---- 1 root dialout 188, 0 Nov 14 11:10 /dev/ttyUSB0

Then, add your account to that group (in the example above, "dialout"):

sudo usermod -a -G dialout USERNAME

To access it immediately (no need to log out and back in) just run, e.g., newgrp dialout.

Now, you should be able to run ./FujiNet-Flasher without switching to root user, or running it under sudo.

Capturing Serial Debug Output

Debugging info from FujiNet can be captured using Fujinet-Flasher. This info may be requested by developers to aid in fixing bugs or troubleshooting hardware problems. These are the steps to capture this information:

  • Connect FujiNet to a computer with a MicroUSB cable
  • Run Fujinet-Flasher and select the the correct port used by Fujinet (ie, COM3 on Windows, /dev/ttyUSB0 on linux)
  • Click the Serial Debug Output button in Fujinet-Flasher
  • Press the RESET button on the FujiNet device (Button C, far right)
  • Debug information will appear in the Fujinet-Flasher window
  • Reproduce your problem with FujiNet then select all (CTRL-A) text in the box and copy it (CTRL-C)
  • Paste the debug output to the developer requesting this information
    • If using AtariAge forum, paste the information into a Spoiler box so the debug output does not fill up the thread
    • Optionally, use a paste site such as Pastebin

Tips for flashing problems

Some people (Bill Kendrick and DrFalken) have found that they could not flash their #FujiNet without holding the "A button" (which is the ESP's 'flash' button) while powering up their #FujiNet. See this "espressif/esptool" bug report comment.

Copyright 2024 Contributors to the FujiNetWIFI project.

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

Clone this wiki locally