FujiNet CLI Flasher - FujiNetWIFI/fujinet-firmware GitHub Wiki

Summary

Use the included Python script in the fujinet-firmware repo to easily flash specific releases and the daily builds without having to install anything but one python module (esptool).

Why would you do this? You want a specific release flashed on your device, or you quickly want to flash without using the Python GUI application, the web flasher, or the tools embedded in the PIO plugins for VSC. If you live in the terminal, this is for you.

Setup

  1. pull the fujinet-firmware repo:
    • $ git pull https://github.com/FujiNetWIFI/fujinet-firmware.git
  2. Install ESPtool
    • $ pip install esptool
  3. Run the flasher:
    • $ python ./fujinet_firmware_uploader.py

[!CAUTION] Did you get an error? sh: 1: esptool.py: not found - you need to install the esptool via pip - see above!

You will be presented with a nice list of the current releases (and nightly builds) from the official FujiNet GitHub repo. Choose one.

Available options:
1) v1.4.0
2) Nightly Builds
3) v1.3.0
4) v1.2.0
5) v1.1.0
6) v1.0.0
7) v0.5.890b4ee
8) Last ESP32-WROOM version
Select an option (number): 1

Then you will be presented with all the platform. Choose one that matches your device.

Available options:
1) fujinet_releases/v1.4.0/fujinet-ADAM-v1.4.0.zip
2) fujinet_releases/v1.4.0/fujinet-APPLE-v1.4.0.zip
3) fujinet_releases/v1.4.0/fujinet-ATARI-8mb-v1.4.0.zip
4) fujinet_releases/v1.4.0/fujinet-ATARI-v1.4.0.zip
5) fujinet_releases/v1.4.0/fujinet-COCO-v1.4.0.zip
6) fujinet_releases/v1.4.0/fujinet-IEC-LOLIN-D32-v1.4.0.zip
Select an option (number): 2

Now the esptool will flash your connected FujiNet (it tries to determine the right USB device for macOS and Linux), reset it, and the FujiNet should boot with the new firmware. You will automatically get logging output in the terminal to confirm. You can stop at any time with [CTRL]-[C].

Verify the first few lines of the FujiNet boot to ensure you are running the right version, on the right board.

Leaving...
Hard resetting via RTS pin...
Monitoring device...
--- Terminal on /dev/ttyUSB0 | 460800 8-N-1
--- Available filters and text transformations: colorize, debug, default, ...
--- More details at https://bit.ly/pio-monitor-filters
--- Quit: Ctrl+C | Menu: Ctrl+T | Help: Ctrl+T followed by Ctrl+H
13:47:31.727 >
13:47:31.727 >
13:47:31.727 > --~--~--~--
13:47:31.727 > FujiNet v1.4 2024-08-07 20:49:13 (APPLE) Started @ 7
13:47:31.727 > Starting heap: 4357680
13:47:31.727 > [src/main.cpp:135] main_setup(): Heap: 212375
13:47:31.727 >

I verified here that I wanted the 1.4 release for Apple - and that is what I have.

That's all, enjoy the FujiNet and its new capabilities.

Other CLI Documentation