FujiNet Flasher

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

Using 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.

Flashing from the command-line (without FujiNet Flasher)

First, download the appropriate firmware files. The latest (where FujiNet Flasher fetches them from) are located at https://fujinet.online/firmware-dl/. (Older releases are not archived at this time; if you are so inclined, you can just checkout the commit you want to build from the "fujinet-platformio" repository and build it manually.)

Sorry, the remaining details are missing. Feel free to edit this wiki!

See also https://github.com/FujiNetWIFI/fujinet-platformio/wiki/Board-bring-up-for-FujiNet-Platform.IO-code

Serial debugging from the command-line (without FujiNet Flasher)

Debugging info going by too quickly to see or capture what you need? Font too small? Access the serial output directly!

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

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.