Skip to content

Home

Jump to bottom Edit New page
Anton Gallmetzer edited this page Jun 14, 2025 · 11 revisions

OpenNept4une Logo

Welcome to the OpenOrangeStorm Wiki!

Before attempting to Upgrade to OpenOrangeStrom, get sure you don't need the printer immediately! Some things might not work out and need a bit of tinkering. This is still a work in progress! The repository this page is referring to is the one of Galloant, where an attempt at fixing some bugs has been made, but is still in evaluation if it's working or not. If you went through the installation process described here and you find your machine to be working, please let us know so we can pull the repository fixes into the mainline.

For now, neither Wifi nor the Elegoo screen is working with OpenOrangeStorm!

If you need help, hop over to Discord and enable the giga-development channel. Before you go there and ask questions, try to solve the issue yourself. That is the best way to learn.
It might be a good idea to get your terminology right, which for we suggest to visit the Terminology page first. Not only will this help you understand better what you're doing and follow the instructions accurately, but it also helps you when asking for help.

Table of Contents

Prerequisites

Flashing OpenOrangeStorm

Download and Preparation:

Download the latest OpenOrangeStrom Image.

Flash the image to the eMMC:

- Linux:

xz -dc -T0 file.img.xz | sudo dd of=/dev/sdX bs=4M conv=fsync status=progress

- MacOS:

- Windows:

  • Use 7z to extract then Rufus to flash

Note If the eMMC is not detected, ensure the chip is the correct way round in the adapter.

Installation:

  • Reinsert the eMMC into the mainboard.
  • If your printer now features an externally accessible microSD slot, reattach the access panel to the printer (Important for cooling).
  • Power on the printer
  • NOTE: Your touchscreen will continue to hang on loading, this is normal please continue with the installation.
  • Access your printer's terminal console (via SSH or Serial)

- SSH (Requires Ethernet Connection to a router/network switch);

  1. Connect the printer via Ethernet to your router / LAN switch (NOT directly to a PC)

  2. Determine the new IP of your printer (two options below):
    a. Use your router's web interface > DHCP lease table.
    b. Or use AngryIP (Settings Cog > Ports > Clear port selection entries, type 7125, Ok, then Start)

  3. Connect via SSH using: ssh mks@YOUR-PRINTERS-IP. Password: makerbase.

- Serial (If ethernet access isn't available);

  1. Connect your computer to the printer's USB-C port (1500000 Baud Serial terminal).
    a. Windows users can use PuTTY. Here is a useful quick connection Guide.
    b. Linux users can use screen for terminal access (linux commands below).

    lsusb

    Find the relevant ttyACM / ttyUSB device then paste yours into the command below.

    screen /dev/tty* 1500000

    To exit screen, press Ctrl + A followed by K, then confirm with Y.

  2. Once connected login using: User: mks. Password: makerbase.

Configure WiFi (can be skipped / not working):

  • To configure WiFi run the following command. 
    sudo nmtui
  • Select Edit a Connection, and press enter.
  • Right arrow to <Add>, and press enter.
  • Down arrow to Wi-Fi, and press enter.
  • Give the profile a name, like Home or Work, then skip down to the SSID (this is your network name).
  • At Security, choose WPA & WPA2 Personal, then add your password. (this security should be correct for most setups)
  • Leave the IPv4 and IPv6 on automatic, and select Ok.
  • Select Back and then Quit.
  • Once connected, consider logging into your WiFi router and enabling a static IP address for your printer. This will prevent the IP address from changing over time. (usually within DHCP settings).

Initial Configurations & Updates

Timezone Configuration:

  • Set the correct timezone through Armbian configuration: 
    sudo armbian-config
  • Navigate to Personal > Timezone to set your zone.
  • Exit the menu then reboot your printer with; 
    sudo reboot

Update pre-loaded plugins

  • Execute the Kiauh script (you may have to run the command again after it updates itself): 
    ~/kiauh/kiauh.sh
  • Select menu Option 2, update all programs. It will take a while to check for updates on the first boot.
  • Type (a) for [Update all] when prompted by ####### Perform action:, then exit kiauh once complete.

Use the reworked OpenOrangeStrom Installer

  • Copy and paste the following command into the terminal

    cd ~/OpenOrangeStorm/ && git remote set-url origin https://github.com/Galloant/OpenOrangeStorm.git && git fetch --all && git reset --hard origin/fixes && git clean -fd

    Followed by

    chmod -R 777 ~/OpenOrangeStorm
~/OpenOrangeStorm/OpenOrangeStorm.sh

  • Select Option (1) (Install/Update OpenOrangeStorm printer.cfg)
    The first run will ask you to select your printer model it then installs the relevant printer.cfg

  • Select Option (2) (Install/Update KAMP/Moonraker/fluiddGUI confs) then select Option 1) All

  • Quit openorangestorm and run;

    sudo reboot

Setup a CAN0 interface:

sudo nano /etc/network/interfaces.d/can0

Copy and paste this configuration:

allow-hotplug can0
iface can0 can static
    bitrate 1000000
    up ip link set $IFACE txqueuelen 128

Press CTRL+X to exit, Y to confirm and ENTER to save. Reboot your system with sudo reboot now.

After reboot, check if CAN0 state is up and running:

ip -details -statistics link show can0

Flashing / Updating Klipper MCUs

  • After the reboot run the command
 openorangestorm
  • Select Menu Option 4) Update MCU & Virtual MCU Firmware to update MCUs
  • Select Option 1 STM32
  • Follow the steps in the terminal
  • If successful, you need to restart the machine (top right ...>Host>Shutdown > wait 20 seconds > power off > wait 20 seconds > power on) and then you can do the first 3 steps for the RP2040

If it doesn't work, you have two options:

  • Go on with the guide as there are other ways to flash the firmware
  • Go to the Discord server and ping Gallo in the #giga-development channel. He wrote the script for the automatic update, but had limited possibilities to try it on a board which was freshly upgraded to OpenOrangeStorm and would need to do some tests. He's on CET (Central European Time), so he might not be available immediately. If you have time to wait, it would be highly appriciated.

**only for the STM32! For the RP2040 visit this page **

  • If the automatic update fails, the firmware file be put in the configuration folder
  • Visit: http://your_printer_ip/#/configure
  • Click the Firmware folder in the Configuration Files column (left)
  • Right-click and Download ZNP-Giga.bin
  • Copy both files to a FAT32 formatted microSD card
  • Safely eject your microSD card (don't insert into the printer just yet)
  • Continue with the script (y)
  • Shutdown the host (top right ...>Host>Shutdown)
  • (Wait ~20s) It is now safe to power off the printer at the power/mains switch
  • Insert the microSD card once the printer is fully powered down
  • Power on the printer, then check the MCU versions in Fluidd's system tab (v0.12.x).
  • You can now remove the microSD from the printer
  • Note: One of the .bin files on the microSD will be renamed to .CUR if the update was successful.

Sidenote You can check if your MCUs are connected via CAN with this command:

cd ~/katapult/scripts && python3 flash_can.py -i can0 -q

but only after you have installed Katapult. Katapult will be installed automatically when running the firmware update script. The output should be something like this:

Resetting all bootloader node IDs...
Checking for Katapult nodes...
Detected UUID: 06727e55c686, Application: Klipper
Detected UUID: 4c61f6fc8b08, Application: Klipper
Query Complete

If nothing works If the update of the MCUs fails, you will need to update them manually. This page will guide you through it.

Post-Installation Setup

Getting the MCU UUIDs

After having finished the firmware update process, restart the machine as before.

After that, run the command: cd ~/katapult/scripts && python3 flash_can.py -i can0 -q

The output should be similar as follows:

Resetting all bootloader node IDs...
Checking for Katapult nodes...
Detected UUID: 06727e55c686, Application: Klipper
Detected UUID: 4c61f6fc8b08, Application: Klipper
Query Complete
  • The first UUID is the mcu UUID (STM32)
  • The second UUID is the mcu1 (RP2040 / printhead)
  • Replace the UUIDs in your printer.cfg with the once you've got like here:
[mcu]
canbus_uuid: cb43a94be3aa

[mcu mcu1]
canbus_uuid: 7c22a34d7700

Fix Communication timeout during homing

  • Run the following command:
 openorangestorm
  • Select 7) * Advanced Options Menu *
  • Then 8) Probe Timeout Fix (Only for Orange Storm Giga)

Find details about why and what here

Webcam Configuration

Configure it via Fluidd or Mainsail

Resizing filesystem

  • Run the following command: 
    openorangestorm
  • Select 7) * Advanced Options Menu *
  • Then 3) Resize Active Armbian Partition - for eMMC > 8GB

Using Mainsail:

  • fluidd is the default web interface for this project, accessible at http://your_printer_ip/
  • That being said, mainsail comes pre-installed
  • Mainsail access via http://my.mainsail.xyz/
  • Enter your printer IP address (or hostname) in the Hostname field

Update remaining 3rd Party Modules:

Importing OrcaSlicer Profiles

  • Download & install the latest Official Release OrcaSlicer
  • Configure your Printer Model in Orca with 0.4mm nozzle and PLA default presets
  • Check / Confirm Bambu Network Engine install
  • Download the latest OrcaSlicer Profiles (ensure you click the icon for raw file download)
  • In OrcaSlicer click [File > Import > Import Configs...]
  • Within each of the three dropdown menus on the left for Printer, Filament & Process select the relevant OpenNept4une User preset (note not to select PETG unless required)
  • Click the WiFi symbol to the right of the Printer preset dropdown, and enter your printer's IP to enable network .gcode upload.
  • Your printer's fluidd interface will now be accessible via OrcaSlicer Device tab.

Printer Calibration & Levelling

Here

Safely Powering Off your Printer

  1. Save any config changes within the Fluidd interface to avoid losing them.
  2. To safely Power-off your printer, either use the touchscreen to shutdown the host or use the Fluidd interface:
    Navigate to the top-right menu, select Host, then Shutdown.
    Wait until the Green LEDs (visible under the printer) turn off
    Then you can power off the machine at the mains power switch.
    This ensures that changes stored in RAM are correctly written to the eMMC, preventing data loss.

Keeping your Printer Updated

Here

How to revert back to Original Elegoo eMMC image:

Visit this page

Add a custom footer
Add a custom sidebar

Clone this wiki locally