Getting Started with OpenOrangeStorm

[Galloant]

The content of this Discussion is mainly taken from the OpenNept4une Wiki and has only a few small changes to help you setup OpenOrangeStrom. You should still know what you're doing and know your way around Klipper and Linux.

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!

I'm not part of the development team for this repository and am merely trying to help out. No one is responsible for anything going on with your printer except you yourself. Please keep that in mind.

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.

Terminology

Before we start, we should get the terminology right, so that you are on the same page.

SBC

SBC stands for Single Board Computer. The ZNP-GIGA board is such a SBC, as for example a Raspberry Pi is. It contains everything a computer needs to function, like a processor, RAM and storage. In this case (like in most others), the CPU (processor) is ARM based and is located under the green heatsink.

eMMC

eMMC stands for embedded multimedia card. It is the storage for the SBC ans stores all the files from the OS. In order to run the OpenOrangeStorm image (Armbian OS, we need to flash it to the eMMC. On the ZNP-GIGA, the eMMC is mounted on spacers on top of the board. It should be labeled as "eMMC". Do not confuse it with the SD card!

MCU

MCU stands for Microcontroller Unit. The MCU is responsible for the actions of the printer, like movement, heating, fans and so on. In the Giga, there are two MCUs: one on the ZNP-GIGA board and one in the printhead (or toolhead). On the main board, the MCU is a STM32, while in the printhead it's a RP2040. The MCUs are programmed with a bootloader and firmware (Klipper firmware in our case) and connect to the SBC (or CPU) via CAN bridge integrated in the mainboard. The MCU on the mainboard has no heatsink on it, while the one in the printhead does.

OS or image

OS stands for Operating System. An "image" or "img" is a snapshot of the OS. When first installing an OS, it is barren and has only the essentials installed. When adding programs, like Moonraker, Klipper, Fluidd and so on, the OS gets loaded and in order to be able to distribute a OS which is preconfigured, we create a image of the state, so that others can flash this image to their storage and have in at the state we desire.

---

Table of Contents

• Prerequisites
• Flashing OpenOrangeStorm
• Initial Configurations & Updates
• Setup a CAN0 interface
• Flashing / Updating Klipper MCUs
• Post-Installation Setup
• Importing OrcaSlicer Profiles
• Printer Calibration & Levelling
• Safely Powering Off your Printer
• Keeping your Printer Updated

---

Prerequisites

• Acquire an eMMC to USB Adapter: MKS USB3 Adapter - AliExpress or Adapter with spare eMMC - AliExpress / 32GB version (without adapter).
• Back up your printer.cfg to a file off your printer.
• Power off the printer and access the Mainboard by removing all silver screws securing the underside access panel.
• Remove the two screws securing the eMMC module and safely lift it free.
• Wifi is not working as for now and you need to connect the printer via Ethernet

---

Flashing OpenOrangeStorm

Download and Preparation:

Download the latest OpenOrangeStrom Image.

Flash the image to the eMMC:

- Linux:

• Use balenaEtcher or dd with;

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

- MacOS:

• Use balenaEtcher

- 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

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

• If the automatic update fails, the firmware fill 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

---

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:

• Update Guide

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

---