FujiNet Flasher

Table of Contents

• Overview
• How to find out when a new version is available?
• Installing Firmware with FujiNet Flasher
• Capturing Serial Debug Output
• Tips for flashing problems

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?

• Consult the "FujiNet Version", "Version Date/Time", and "Build Date/Time" under the "Latest Firmware Version Info" section of https://fujinet.online/download/
• mozzwald's "#FujiNet Firmware Update Information" thread at AtariAge
• Maybe also the "FujiNet User's Group" on Facebook
• Follow some key FujiNet developers on Twitter
  • Thomas Cherryhomes (@tschak)
  • @mozzwald

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. (Details needed.)

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

Windows

(Details needed.)

macOS

(Details needed.)

Linux

You can simply cat the device, e.g., cat /dev/ttyUSB0 to watch the output in a terminal, or cat /dev/ttyUSB0 > some-log-file.txt to capture to a file.

Need timestamps? You can use awk to add them to each line, like so: cat < /dev/ttyUSB0 | awk '{ print strftime("%Y-%m-%d %H:%M:%S"), $0; }'

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.