Home - OpenNeptune3D/OpenNept4une GitHub Wiki

OpenNept4une Logo

Welcome to the OpenNept4une Wiki!

Getting Started with OpenNept4une

Discord

Table of Contents


Prerequisites


Flashing OpenNept4une

Download and Preparation:

Download the latest OpenNept4une Image that matches your printer's model. Select the correct file based on 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

Flash the image to the eMMC:

- Linux:

  • Use balenaEtcher

  • Or alternativley with dd & xz using the command below;

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

- MacOS:

- Windows:

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.
  • Ensure your printer now features an externally accessible microSD slot Hidden microSD Access
  • Important re-attach the access panel to the printer (Crucial for cooling the mainboard SoC).
  • Power on the printer
  • NOTE: Your touchscreen will typically not function at this stage, 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)
    Note May require you to use a USB-A port on your PC with a USB-A to USB-C cable.
    a. Windows users can use PuTTY. Here is a useful quick connection Guide.
    b. Linux users can use picocom for terminal access.
    • Install picocom with the following command.
    sudo apt update && sudo apt install picocom -y
    
    • Find the relevant ttyACM / ttyUSB device.
    lsusb
    
    • Once you have identified the printer's serial device (usually ttyUSB0)
    picocom -b 1500000 /dev/ttyUSB0
    
    OR
    picocom -b 115200 /dev/ttyUSB0
    
  2. When you see Terminal ready or a login prompt, type mks, Enter, then type makerbase (username/password). Tip to exit picocom, press Ctrl + A followed by Ctrl + X.

Configure WiFi:

  • 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 Localisation > Change Global Timezone to set your zone.
  • Exit the menu, then reboot your printer with;
    sudo reboot
    

Update OpenNept4une Installer & printer.cfg

  • Copy and paste the following command into the terminal
    ~/OpenNept4une/OpenNept4une.sh
    
  • Select Option (1) (Install/Update OpenNept4une printer.cfg)
    The first run will ask you to select your printer model it then installs the relevant printer.cfg
    Note for N4 and N4Pro users ONLY, determine your Stepper & PCB Version
  • Select Option (2) (Install/Update KAMP/Moonraker/fluiddGUI confs) then select Option 1) All
  • Quit opennept4une and run;
    sudo reboot
    

Flashing / Updating Klipper MCUs

  • After the reboot run the command
    opennept4une
    
  • Select Menu Option 4) Update MCU & Virtual MCU Firmware to update MCUs
  • Select Option 4 ALL
  • The STM32 (main) MCU firmware .bin files will be generated first
  • Visit: http://your_printer_ip/#/configure
  • Click the Firmware folder in the Configuration Files column (left)
  • Right-click and Download X_4.bin and elegoo_k1.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)
  • If you don't have a pico/MellowFly USB accelerometer, enter s to Skip when prompted, otherwise connect the device in bootsel mode
  • The virtual MCU rpi firmware will now be generated and flashed automatically
  • After the auto reboot completes, enter fluidd, then shut down the host (top right ...>Host>Shutdown)
  • (Wait ~20s) It is now safe to power off the printer at the power/mains switch
  • Note: Disconnect any additional devices attached via front panel USB eg. Webcam, CoPrint ECM/KCM/Chroma head. Otherwise, they may cause the firmware upgrade to fail, whilst still renaming one of the '.bin' file extensions to '.cur'.
  • Insert the microSD card once the printer is fully powered down Note microSD cards' pins face upwards.
  • Power on the printer, then check the MCU versions in Fluidd's system tab (v0.13.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.

Updating 3rd-party modules

  1. Enter fluidd's Settings tab (the COG in the left toolbar)
  2. Click the option Software Updates
  3. Click Check for Updates (may take some time)
  4. Once checked, click Update All
  • Note: fluidd may incorrectly report outstanding OS Packages

Post-Installation Setup

Webcam Configuration:

  • If you have a USB webcam connected, auto-configure with the following:
    opennept4une
    
  • Select 7) * Advanced Options Menu *
  • Then 2) Webcam Auto-Config (mjpg-streamer)
    Configure as desired and take note of URL's generated at the end of setup.
  • In fluidd navigate to Settings > Camera > USB .Paste the URLs generated in the previous step into the relevant fields.
Screenshot 2024-08-27 at 16 41 59
  • Note: fluidd might need to be refreshed in the browser
  • For making any manual webcam configuration changes, use;
    sudo nano /etc/systemd/system/mjpg-streamer.service
    

Resizing filesystem (for 32GB eMMC upgrade ONLY)

  • Run the following command:
    opennept4une
    
  • 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://your_printer_ip:81

LED Configuration (*for some v1.1 N4 or N4Pro users ONLY):

  • *If your v1.1 N4 / N4Pro LED control via fluidd is working, SKIP this section.
  • Otherwise, if you are having issues controlling LEDs on your v1.1 N4 / N4Pro.
  • Open your user_settings.cfg and paste the following.
    #############################################################################
    #   Alt (v1.1) LED Config
    #############################################################################
    
     [output_pin Frame_Light]
     pin: rpi:gpiochip2/gpio2
    
     [output_pin Part_Light]
     pin: rpi:gpiochip2/gpio15
    
  • Click Save & Restart

Importing OrcaSlicer Profiles

  • Download & install the latest Official Release OrcaSlicer
  • Configure your Printer Model in OrcaSlicer with a 0.4mm nozzle and only tick following two filament profiles Generic PLA + Generic PETG
  • Check / Confirm Bambu Network Engine install
  • Download the latest OrcaSlicer Profiles
  • 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


Recovery - Back to Factory

Here


⚠️ **GitHub.com Fallback** ⚠️