Skip to content

Home

Jump to bottom Edit New page
HalfManBear edited this page Feb 28, 2024 · 101 revisions

OpenNept4une Logo

Welcome to the OpenNept4une Wiki!

Getting Started with OpenNept4une

Discord

Table of Contents

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.
  • For N4 or N4Pro users ONLY, determine your Stepper & PCB Version.
  • If your printer lacks an externally accessible microSD slot (located on the front I/O to the left of the USB-C port)
    follow these instructions: Hidden microSD Access. The microSD is needed for updating the Klipper MCU firmware.
  • Connect the printer via Ethernet.

Flashing OpenNept4une

Download and Preparation:

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).
  • 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)
  • Power on the printer and connect via SSH using: ssh mks@YOUR-PRINTERS-IP. Password: makerbase.

Initial Configurations & Updates

  • 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.
  • Update and run the OpenNept4une script: Copy and paste the following command into the terminal 
    cd ~/OpenNept4une/ && git remote set-url origin https://github.com/OpenNeptune3D/OpenNept4une.git && git fetch --all && git reset --hard origin/main && git clean -fd
    Followed by 
    ~/OpenNept4une/OpenNept4une.sh
    Select Option (1) to install the latest printer configurations and accept updates to other configurations as prompted, accept the reboot prompt.

Flashing / Updating Klipper MCUs:

  • After the reboot run 
    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, power off the printer
  • 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.

Post-Installation Setup

Configure WiFi & Install the display (Touch-screen):

  • To configure WiFi / to install the touch-screen service, re-run; 
    opennept4une
  • Select Option (2) in the OpenNept4une menu for WiFi and Option (5) for touch-screen install
  • Ensure your touch-screen is on the latest Elegoo firmware, either UI v1.2.11 or UI v1.2.12 Download Here

Timezone Configuration:

  • Set the correct timezone through Armbian configuration: 
    sudo armbian-config
    Then navigate to Personal > Timezone.

Webcam Configuration:

  • If you have a USB webcam connected, auto-configure with the following: 
    opennept4une
  • Select 6) * Advanced Options Menu *
  • Then 2) Webcam Auto-Config (Crowsnest)
  • Note: fluidd might need to be refreshed in the browser

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

LED Configuration (For v1.1 N4 or N4Pro users ONLY):

  • If LED control via fluidd is working, ignore this section.
  • Otherwise, if you are having issues controlling LEDs on your v1.1 N4 / N4Pro.
  • Open your printer.cfg and navigate to LED Config, follow the instructions there to enable the Alt LED Config.

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 OpenNept4une User preset
  • 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.

Klipper & OrcaSlicer Printer Calibration

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, 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

Add a custom footer
Add a custom sidebar

Clone this wiki locally