Skip to content

Home

Jump to bottom Edit New page
HalfManBear edited this page Jul 31, 2026 · 101 revisions

OpenNept4une Logo

Welcome to the OpenNept4une Wiki!

Getting Started with OpenNept4une

Discord

Table of Contents

Prerequisites

  • Get an eMMC-to-USB adapter:
  • Back up printer.cfg to a device other than the printer.
  • Switch off the printer and disconnect it from the mains supply.
  • Remove all silver screws that secure the underside access panel.
  • Remove the access panel.
  • Remove the two screws that secure the eMMC module, and carefully lift the module from the mainboard.
  • For Neptune 4 and Neptune 4 Pro only, identify the Stepper and PCB Version.
  • Make sure that the printer has an externally accessible microSD slot. The slot is on the front I/O panel, to the left of the USB-C port.
  • If the microSD slot is not externally accessible, follow the Hidden microSD Access instructions.

NOTE: You need the microSD slot to update the Klipper MCU firmware.

Flashing OpenNept4une

Download and preparation

OpenNept4une currently supports these mainboards:

  • ZNP-K1-V1.0
  • ZNP-K1-V1.1
  • ZNP-K1-V2.0

OpenNept4une does not currently support these configurations:

  • ZNP-K1-2.2
  • ZNP-K1-2.3
  • Newer mainboard versions
  • Mainboards with USB printheads

The project needs additional community data and development work before full support can be added.

Mainboard Versions →

Download the latest OpenNept4une image for your printer model.

Neptune 4 or Neptune 4 Pro

Neptune4+Pro-v0.1.*-ZNP-K1-V1.x.img.xz

Neptune 4 Plus or Neptune 4 Max

Neptune4-Plus+Max-v0.1.*-ZNP-K1-V2.0.img.xz

CAUTION: Make sure that the image matches both the printer model and the mainboard version. An incorrect image can prevent the printer from starting correctly.

Flash the image to the eMMC

Linux

Use balenaEtcher.

Alternatively, use xz and dd:

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

CAUTION: Replace /dev/sdX with the correct eMMC device. An incorrect device path can overwrite another storage device.

macOS

Use balenaEtcher.

Windows

Use balenaEtcher.

If balenaEtcher stops unexpectedly at the end of validation:

  1. Extract the downloaded .xz file to an .img file.
  2. Flash the extracted .img file.

Alternatively:

  1. Use 7-Zip to extract the .xz file.
  2. Use Rufus to flash the .img file.

NOTE: If the computer does not detect the eMMC module, make sure that the module is installed in the adapter in the correct orientation.

Installation

  • Reinstall the eMMC module on the mainboard.
  • Install the two eMMC-module screws.
  • Make sure that the printer has an externally accessible microSD slot. If necessary, follow Hidden microSD Access.
  • Reinstall the underside access panel and all of its screws.
  • Switch on the printer.

CAUTION: Do not operate the printer without the underside access panel. The panel is necessary for correct airflow and mainboard SoC cooling.

NOTE: The touchscreen will usually not operate at this stage. This is normal. Continue the installation through SSH or a serial connection.

Access the terminal through SSH

SSH requires an Ethernet connection to a router or network switch.

  1. Connect the printer by Ethernet to your router or LAN switch.
  2. Do not connect the printer directly to a computer.
  3. Find the new printer IP address:
    • Use the DHCP lease table in your router interface, or
    • Use Angry IP Scanner:
      1. Open Settings Cog > Ports.
      2. Clear the port selection entries.
      3. Enter 7125.
      4. Select OK.
      5. Select Start.
  4. Connect through SSH:
ssh mks@YOUR-PRINTER-IP

Use this password:

makerbase

Access the terminal through a serial connection

Use this method if Ethernet is not available.

  1. Connect the computer to the printer USB-C port.
  2. Configure the serial terminal for 1500000 baud.

NOTE: Some computers require a USB-A port and a USB-A-to-USB-C cable.

Windows

Use PuTTY.

This quick connection guide gives additional instructions.

Linux

Install picocom:

sudo apt update && sudo apt install picocom -y

Identify the printer serial device:

lsusb

The serial device is usually /dev/ttyUSB0.

Connect at 1500000 baud:

picocom -b 1500000 /dev/ttyUSB0

If necessary, try 115200 baud:

picocom -b 115200 /dev/ttyUSB0

When Terminal ready or a login prompt appears:

  1. Enter mks.
  2. Press Enter.
  3. Enter makerbase.
  4. Press Enter.

TIP: To exit picocom, press Ctrl+A, and then press Ctrl+X.

Configure Wi-Fi

Run:

sudo nmtui
  1. Select Edit a Connection, and press Enter.
  2. Move to <Add>, and press Enter.
  3. Select Wi-Fi, and press Enter.
  4. Enter a profile name, such as Home or Work.
  5. Enter the network name in the SSID field.
  6. At Security, select WPA & WPA2 Personal.
  7. Enter the Wi-Fi password.
  8. Leave IPv4 and IPv6 set to automatic.
  9. Select OK.
  10. Select Back.
  11. Select Quit.

After the printer connects, configure a DHCP reservation, also called a static lease, in your router. This prevents the printer IP address from changing.

Initial Configuration and Updates

Configure the timezone

Run the Armbian configuration tool:

sudo armbian-config
  1. Select Localisation.
  2. Select Change Global Timezone.
  3. Select the correct timezone.
  4. Exit the menu.
  5. Restart the printer:
sudo reboot

Update the OpenNept4une installer and printer.cfg

Run:

~/OpenNept4une/OpenNept4une.sh
  1. Select Option (1) — Install/Update OpenNept4une printer.cfg.
  2. On the first run, select the correct printer model. The installer installs the applicable printer.cfg.
  3. For Neptune 4 and Neptune 4 Pro only, make sure that you identified the correct Stepper and PCB Version.
  4. Select Option (2) — Install/Update KAMP/Moonraker/fluiddGUI confs.
  5. Select Option 1) All.
  6. Exit opennept4une.
  7. Restart the printer:
sudo reboot

Flashing or Updating Klipper MCUs

After the printer restarts, run:

opennept4une
  1. Select 4) Update MCU & Virtual MCU Firmware.
  2. Select 4) ALL.
  3. Wait while the script generates the STM32 main-MCU .bin files.
  4. Open:
http://YOUR-PRINTER-IP/#/configure
  1. In the left Configuration Files column, open the Firmware folder.
  2. Download:
    • X_4.bin
    • elegoo_k1.bin
  3. Format a microSD card as FAT32.
  4. Copy both .bin files to the microSD card.
  5. Safely eject the microSD card from the computer.
  6. Do not insert the card into the printer yet.
  7. Return to the script and enter y to continue.
  8. If you do not have a Pico or Mellow Fly USB accelerometer, enter s to skip when prompted.
  9. If you have a supported USB accelerometer, connect it in BOOTSEL mode.
  10. Wait while the script generates and flashes the virtual rpi MCU firmware.
  11. Wait for the automatic restart to complete.
  12. Open Fluidd.
  13. Select the upper-right ... menu.
  14. Select Host > Shutdown.
  15. Wait approximately 20 seconds.
  16. Switch off the printer at the mains switch.

CAUTION: Before you update the main MCU, disconnect all additional devices from the front USB port. This includes webcams and CoPrint ECM, KCM, or Chroma hardware. An attached USB device can cause the update to fail. A failed update can still rename a .bin file to .cur.

  1. Make sure that the printer is fully powered off.
  2. Insert the microSD card into the printer with its contacts facing upwards.
  3. Switch on the printer.
  4. In the Fluidd System tab, make sure that the MCU versions show v0.13.x.
  5. Remove the microSD card.

NOTE: After a successful update, one of the .bin files on the microSD card is renamed to .CUR.

Updating Third-Party Modules

  1. In Fluidd, select Settings using the cog in the left toolbar.
  2. Select Software Updates.
  3. Select Check for Updates.
  4. Wait for the check to complete.
  5. Select Update All.

NOTE: Fluidd can incorrectly report outstanding OS Packages after the update.

Post-Installation Setup

Update the touchscreen display service

Run:

opennept4une
  1. Select 5) Install/Update Touch-Screen Service (BETA).
  2. Enter y at the first prompt.
  3. Wait for the setup to complete.
  4. On the touchscreen, select Settings > About Machine.
  5. Check the UI Version.
  6. Make sure that the touchscreen uses Elegoo firmware version UI v1.2.14 or later.
  7. Restart the printer:
sudo reboot

Update the touchscreen UI firmware

Do this procedure only if the touchscreen UI version is earlier than UI v1.2.14.

  1. Download UI_1.2.14_240705.tft.
  2. Format a microSD card as FAT32.
  3. Copy the downloaded file to the microSD card.
  4. Shut down the printer host.
  5. Switch off the printer.
  6. Remove the four screws from the rear of the touchscreen.
  7. Insert the microSD card into the internal touchscreen microSD slot.
  8. Switch on the printer.
  9. Wait while the touchscreen shows the update process.
  10. After the update is complete, switch off the printer.
  11. Remove the microSD card from the touchscreen.
  12. Reinstall the touchscreen rear cover and its four screws.
  13. Restart the printer.

Configure a webcam

If a USB webcam is connected, run:

opennept4une
  1. Select 7) * Advanced Options Menu *.
  2. Select 2) Webcam Auto-Config (mjpg-streamer).
  3. Configure the webcam as required.
  4. Record the URLs that the installer shows at the end of the setup.
  5. In Fluidd, select Settings > Camera > USB.
  6. Paste the generated URLs into the applicable fields.
Screenshot 2024-08-27 at 16 41 59

NOTE: Refresh Fluidd in the browser if the camera does not appear.

For manual webcam configuration, edit:

sudo nano /etc/systemd/system/mjpg-streamer.service

Resize the filesystem

Do this procedure only for an eMMC module larger than 8 GB, such as a 32 GB upgrade.

Run:

opennept4une
  1. Select 7) * Advanced Options Menu *.
  2. Select 3) Resize Active Armbian Partition - for eMMC > 8GB.

Use Mainsail

Fluidd is the default web interface:

http://YOUR-PRINTER-IP/

Mainsail is preinstalled and is available at:

http://YOUR-PRINTER-IP:81

Configure the LEDs

Do this procedure only for some Neptune 4 or Neptune 4 Pro printers with a v1.1 mainboard.

If LED control operates correctly through Fluidd, skip this section.

If LED control does not operate correctly:

  1. Open user_settings.cfg.
  2. Add:
#############################################################################
#   Alternative v1.1 LED Configuration
#############################################################################

[output_pin Frame_Light]
pin: rpi:gpiochip2/gpio2

[output_pin Part_Light]
pin: rpi:gpiochip2/gpio15
  1. Select Save & Restart.

Importing OrcaSlicer Profiles

  1. Download and install the latest official OrcaSlicer release.
  2. Configure the correct Printer Model.
  3. Select a 0.4 mm nozzle.
  4. Select only these initial filament profiles:
    • Generic PLA
    • Generic PETG
  5. Confirm that Bambu Network Engine is installed.
  6. Download the latest OpenNept4une OrcaSlicer profiles.
  7. In OrcaSlicer, select File > Import > Import Configs....
  8. In each of the three menus on the left, select the applicable OpenNept4une User preset:
    • Printer
    • Filament
    • Process
  9. Do not select a PETG preset unless you will print PETG.
  10. Select the Wi-Fi symbol to the right of the Printer preset.
  11. Enter the printer IP address to enable network .gcode upload.

The printer Fluidd interface is now available through the OrcaSlicer Device tab.

Printer Calibration and Levelling

Follow the Printer Calibration — Klipper and OrcaSlicer instructions.

Safely Powering Off the Printer

  1. Save all configuration changes in Fluidd.
  2. Shut down the host with the touchscreen, or use Fluidd:
    1. Open the upper-right menu.
    2. Select Host.
    3. Select Shutdown.
  3. Wait until the green LEDs below the printer go off.
  4. Switch off the printer at the mains switch.

CAUTION: Do not switch off the mains supply before the host completes its shutdown. An incorrect shutdown can prevent data in RAM from being written to the eMMC and can cause data loss.

Keeping the Printer Updated

Follow the Keeping Your Printer Updated instructions.

Recovery: Return to Factory Software

Follow the Reverting Back to Original Elegoo Firmware and Software instructions.

Add a custom footer
Add a custom sidebar

Clone this wiki locally