Skip to content

Transform your Neptune 4 3D printer with OpenNept4une, a collection of scripts designed to replace the manufacturer's software, reverting to the original open-source projects for enhanced performance, flexibility, and features.

License

Notifications You must be signed in to change notification settings

wasdennnoch/OpenNept4une

 
 

Repository files navigation

OpenNept4une

De-Elegoo-izing the Neptune 4 Series 3D Printers

NOTE: The touch-screen will not be functional after this! Please download mobileraker phone app instead

LED’s, ADXL & WiFi Working on all Variants

Credits:

  • Community Members: SQUIRRELYMOOSE, DanDonut, Jaerax, SmartHome42/Printernbeer & Tom's Basement
  • Projects:

Image Features

  • Armbian 24.02.0-trunk Bookworm with Linux 6.1.67-current-rockchip64 (Credit)
  • Elegoo Services Removed (No Z-Axis Issues)
  • KAMP configured and installed
  • Bed Leveling Macros
  • Axis_Twist_Comp_Tune - Macro (Klipper Docs)
  • PID Calibration Macros
  • Easy WiFi config
  • Axis Twist Compensation Configured
  • Working segmented bed heaters (N4Pro)
  • Armbian packages updated (as of Dec 2023)
  • No need for Elegoo Firmware Updates (Updated in Fluidd GUI or Kiauh)
  • Crowsnest Current (Main) w/ ustreamer
  • Orca Slicer Profiles Provided
  • Simplified printer.cfg (Credit: Modified SmartHome42/Printernbeer & Tom's Basement Neptune 4 Config)
  • Renamed variables for readability
  • Corrected instructions for Flashing v0.12 Klipper MCU Firmware
  • Firmware Retraction configured
  • E & Z Steppers configured for 32 microsteps
  • X & Y Steppers at 16 microsteps with Interpolation and stealthChop enabled
  • SPI ADXL345 & Mellow Fly-ADXL345 USB Accelerometer configuration included

Install Procedure - Re-flash eMMC with Latest OpenNept4une Release Image

Overview:

  1. Determine stepper motor current & PCB version
  2. Flash eMMC with latest OpenNept4une release image
  3. Run the install script to upgrade / make further settings
  4. Update third party modules in Kiauh / Fluidd or Mailsail
  5. (Optional) Flash MCU as described here

Preparation:

The setup script will prompt you for two inputs: the stepper motor current, as well as the PCB version. ELEGOO has released the printers with two different types of steppers using different current and multiple board revisions. Warning: Choosing the wrong current might damage the stepper motors permanently, so it is better to double check, before picking a value.

Determining Stepper Motor Current: There are multiple ways to determine which current the steppers are running at, you may chose either of them to determine which current your servos use:

  1. Checking the serial number (as suggested by ELEGOO): In the official firmware upgrade guide ELEGOO suggests to use the serial number that is printed onto the bar code of your printer, to determine which servo is used:

    serial number composition

    For Neptune 4: Before July 2023, it is using the 0.8A steppers, in and after July 2023 the 1.2A ones.

    For Neptune 4 Pro: Before June 2023, it is using the 0.8A steppers, in and after June 2023 the 1.2A ones.

  2. Checking the stock printer.cfg that shipped with your printer: If you still have access to your printers files, you can check the printer.cfg for the current value. In the "TMC UART configuration" section, you will find the tmc2209 stepper configuration. The run_current value of the stepper_x and stepper_y will either say "0.8" or "1.2", that is your printers stepper motor current to input into the install script.

  3. (Most safe) checking the inscription on the steppers themselves: Check the side of the X/Y stepper motors, they should either say "BJ42D15-26V77" which is the 0.8A or "BJ42D22-53V04" which is the 1.2A current variant. See this image for a comparison.

Determining the PBC Version:

The second value needed by the install script is the PCB version. When you remove the eMMC for flashing make sure you keep an eye on the silkscreening on the PCB, it should either state V1.0 or V1.1, that is the input value when prompted in the script (see the yellow squares in these images for reference):

version 1.0 version 1.1

Requirements:

  • Makerbase MKS EMMC-ADAPTER V2 USB 3.0 Reader For MKS EMMC Module: AliExpress
  • Alternatively, a spare eMMC & eMMC > microSD adapter: AliExpress

Printer Terminal Access Options:

Terminal / Shell access via SSH (Requires ethernet connection) -

ssh mks@printer ip
Password = makerbase
User: root can login via - root:makerbase\ (not advised)
------------------------------------------------

PuTTY / Serial terminal access (Without Ethernet) -

Connect N4P USB-C port to PC Then connect via Serial COM8 (yours will be different) set baudrate to 1500000

User: mks
Pass: makerbase

------------------------------------------------

Installation:

  • See the Releases section for the latest pre-configured OpenNept4une eMMC Image. Flash with balenaEtcher or dd.
  • Recommended to Back-Up original eMMC beforehand.
  • Run the following startup scripts with Ethernet connected (as user mks) to load the correct machine and printer.cfg
cd ~/OpenNept4une/ && git fetch --all && git reset --hard origin/main && git clean -fd
chmod +x ~/OpenNept4une/OpenNept4une.sh && ~/OpenNept4une/OpenNept4une.sh
  • Run Install latest OpenNept4une Printer.cfg

  • If you have a v1.1 N4/Pro, delete LED Control v1.0 in your new printer.cfg & un-comment v1.1 LED section.

General Configuration Instructions

Follow these steps to configure the basic settings on your Neptune 4 printer's custom Armbian image:

Configure Correct Timezone

  1. Access Armbian Configuration: Open the terminal and enter the following command:
  sudo armbian-config
  1. Set Timezone:
  • Navigate to Personal.
  • Then select Timezone.
  • Choose and set your correct timezone.

Configure Wi-Fi

  1. Access Network Manager: Use the following command in the terminal to open the network manager:
  sudo nmtui
  1. Connect to Wi-Fi:
  • In the network manager, navigate to Activate a connection.
  • Select your Wi-Fi network and enter the necessary credentials to connect.

Remember to save your settings before exiting any configuration menus.

OrcaSlicer Configs

  • Download the latest Official Release OrcaSlicer
  • Configure Orca defaults for your machines model before import.
  • Check/confirm Bambu Network Engine install
  • Download the latest OrcaSlicer Profiles
  • In OrcaSlicer click [File > Import > Import Configs...]

Fluidd / Klipper Calibration: -

Config / Tuning Macros below (found pre-configured in Fluidd | BedTune/Level macros will begin after heating- do Probe Z Offset cold):

------------------------------------

BED_LEVEL_SCREWS_TUNE
[Klipper Docs] (Rerun macro after each round of corrections)

CALIBRATE_PROBE_Z_OFFSET
(Paper Thickness Test. When you determine a value, click Accept and run a SAVE_CONFIG command after)

AUTO_FULL_BED_LEVEL
(Not required as using KAMP meshes before print, but useful to see how level the whole bed is - Click Save Config & Restart after)

-------------------------

(Note: Do each of these separately and from a low temp not whilst hot if Non-Pro only do the inner bed PID macro after tuning the extruder)

PID_TUNE_EXTRUDER
PID_TUNE_INNER_BED
PID_TUNE_OUTER_BED (N4Pro only)

-------------------------

Pressure advance value will need your own data.
[https://www.klipper3d.org/Pressure_Advance.html]

Input shaping values will also need your own data
[https://www.klipper3d.org/Resonance_Compensation.html]
(SPI ADXL345 & Mellow Fly-ADXL345 Pre Configured for tuning)

After editing configs or calibrating, save in the fluidd interface, then in fluidd select the top right menu > Host > reboot. Avoid direct power cycles; this ensures changes are saved from RAM to eMMC.

Slicer Settings

(If using the provided OrcaSlicer profiles you can skip this)

Orcaslicer

START CODE

NOTE all text including PRINT_START and after must be on one line

;Nozzle diameter = [nozzle_diameter]
;Filament type = [filament_type]
;Filament name = [filament_vendor] 
;Filament weight = [filament_density]
PRINT_START BED_TEMP=[hot_plate_temp_initial_layer] EXTRUDER_TEMP=[nozzle_temperature_initial_layer] AREA_START={first_layer_print_min[0]},{first_layer_print_min[1]} AREA_END={first_layer_print_max[0]},{first_layer_print_max[1]}

PRINT END CODE

PRINT_END

Displaying Thumbnails on the Original Display

Currently only Orcaslicer is capable of generating the required thumbnail data. In the Advanced section of the printer settings select ColPic for Format of G-code thumbnails. The sizes for G-code thumbnails need to have 160x160 as the first size. Additional sizes can optionally be added after that.

Prusaslicer

START CODE

NOTE all text including PRINT_START and after must be on one line

;Nozzle diameter = [nozzle_diameter]
;Filament type = [filament_type]
;Filament name = [filament_vendor]
;Filament weight = [filament_density]
PRINT_START BED_TEMP=[first_layer_bed_temperature] EXTRUDER_TEMP=[first_layer_temperature] AREA_START={first_layer_print_min[0]},{first_layer_print_min[1]} AREA_END={first_layer_print_max[0]},{first_layer_print_max[1]}

PRINT END CODE

PRINT_END

About

Transform your Neptune 4 3D printer with OpenNept4une, a collection of scripts designed to replace the manufacturer's software, reverting to the original open-source projects for enhanced performance, flexibility, and features.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Python 65.7%
  • Shell 34.3%