Skip to content

Home

Jump to bottom Edit New page
HalfManBear edited this page Apr 13, 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:

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).
  • 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.
  • If your eMMC is a different size than the image expand your partition to take advantage of additional space. sudo systemctl start armbian-resize-filesystem Some sources suggest this is automatic others do not.

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 enter fluidd, then 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.

Post-Installation Setup

Configure WiFi:

  • To configure WiFi / to install the touch-screen service, re-run; 
    opennept4une
  • Select Option (2) in the OpenNept4une menu for WiFi. (WiFi credentials with spaces / some special characters may cause failure to authenticate or connect).
  • Once connected, consider logging into your WiFi router and enabling a static IP address for your printer on the LAN. This will prevent the IP address from changing over time. (usually within DHCP setting).

Install Touchscreen Display Service:

  • Select 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
  • Reboot your printer with; 
    sudo reboot

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

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

Update remaining 3rd Party Modules:

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

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