Skip to content

Latest commit

 

History

History

archive

README.md

As of Sept 29th, 2024

I have switched to OpenNept4une. I will archive a lot of the work I have done here so it's not lost, but it is no longer representative of my printer configuration.

There may be another way...

https://github.com/dvystrcil/neptune/blob/main/Notes%20on%20Updating%20Everything.md

How to Update Neptune 4 Using krakjoe's Method

Laying down some expectations... I put this repo together to accomplish a few goals

  • A place to back up my configuration
  • A place to update my Neptune 4 Pro using automation
  • A place to practice using Ansible

I am leaning heavily on the work done by krakjoe, a user out on the Elegoo Discord. He was able to provide and update Klipper and Moonraker specifically for use with the BTT Eddy probe. This resulted in allowing us to bring our Neptunes up to spec with the rest of the world. Let's be clear. He is allowed to do this. He is doing this on his own time. He is not affiliated with Elegoo.

If you came here looking for a more open and up-to-date way to keep your Neptune up to spec, there is the OpenNept4une project, where you can get the latest Klipper, Moonraker, etc... They are a fine team and as an open source project I encourage any who can help to please do so.

Finally, I am not an expert in 3D printers, Klipper, or Moonraker... this is a hobby I enjoy dabbling in.

If you ask me for support, please read that last sentence again. I can only help with things that I have personally written in this repo.

What to expect from this repo:

  • A guide to installing krakjoe's work. I hope you can leverage the ansible playbooks I have written.
  • A view into my personal printer configs. Nothing special here folks, your printer config will likely be different. Move along...

Installation

Requirements

You need to do a few things before you begin

  • Install Ansible
  • Fork or pull this repo to where you are doing the work. Cloning to your printer is OK if you have the space available.
  • Update your printer to the latest firmware. If you know what you are doing you could probably use older firmware, but I started by updating to NEPTUNE 4 PRO - APP_V1.1.3.1-UI_1.2.14-20240705-EN which is for my printer (Neptune 4 Pro).

Step 0 - The Automated Way of 1 thru 3

Clone this repo

git clone https://github.com/dvystrcil/neptune.git
cd neptune

Change directory to the ansible folder, make run-update.sh executable and run it

cd ansible
sudo chmod +x run-update.sh
./run-update.sh

Let Ansible do its thing. It should take about 5 minutes. If a reboot occurs then a kernel update is applied (rare occurrence). Just run-update.sh again.

Extra Credit: Correct your Time Zone

Edit the playbooks/system/time-zone.yaml so the name: America/Los_Angeles reflects the zone you want. Then come back to the ansible directory and run:

ansible-playbook -i inventory.ini playbooks/system/time-zone.yaml

More Extra Credit: You may have caught on that the playbooks are fairly granular. This means you can pick what task you want, even mix them around, or edit them to your liking. There are tons of resources about ansible out there and to be honest their documenation is pretty good.

Step 1 - Update Your OS

So you seem to be someone who likes to type a lot. Fair enough.

Update your sources, because if they are original, it's broken.

Open your /etc/apt/sources.list in your favorite editor (like nano), and replace this line:

deb http://deb.debian.org/debian buster-backports main contrib non-free

with this:

deb http://archive.debian.org/debian buster-backports main contrib non-free

Then, update your OS

sudo apt update && sudo apt upgrade -y && sudo apt autoremove -y

Step 2 - Update Klipper

Here is where you get to see how we are leaning into krakjoe's work.

cd /home/mks/klipper
git init
git remote add n4.klipper https://git.krakjoe.dev/n4.klipper.git
git fetch n4.klipper n4/master
git reset --hard FETCH_HEAD
git pull n4.klipper n4/master

Why are we initializing a git repo? It's because Elegoo have their own repo and does not want others to pull from it. So they delete their .git folder.

The Macro max_accel_to_decel Has Been Depricated

You can read more details about this on the Klipper Config Changes log.

If you are seeing this message in Klipper you need to edit your printer.cfg with the following:

image

[gcode_macro PRINT_END] Replace:

    {% set RUN_DECEL    = printer.configfile.settings['printer'].max_accel_to_decel|float %}
    SET_VELOCITY_LIMIT VELOCITY={RUN_VELOCITY} ACCEL={RUN_ACCEL} ACCEL_TO_DECEL={RUN_DECEL}

with:

    {% set RUN_CRUISE   = printer.configfile.settings['printer'].minimum_cruise_ratio|float %}
    SET_VELOCITY_LIMIT VELOCITY={RUN_VELOCITY} ACCEL={RUN_ACCEL} MINIMUM_CRUISE_RATIO={RUN_CRUISE}

[gcode_macro CANCEL_PRINT] Replace:

    {% set RUN_DECEL    = printer.configfile.settings['printer'].max_accel_to_decel|float %}
    SET_VELOCITY_LIMIT VELOCITY={RUN_VELOCITY} ACCEL={RUN_ACCEL} ACCEL_TO_DECEL={RUN_DECEL}

with:

    {% set RUN_CRUISE   = printer.configfile.settings['printer'].minimum_cruise_ratio|float %}
    SET_VELOCITY_LIMIT VELOCITY={RUN_VELOCITY} ACCEL={RUN_ACCEL} MINIMUM_CRUISE_RATIO={RUN_CRUISE}

[printer] Remove the max_accel_to_decel property:

max_accel_to_decel: 20000

If you are not using the [adxl345] or [resonance_tester] (only the plus and max have this built in) and you have not added an accellarometer yourself. Then remove these sections from your printer.cfg.

Elegoo's Configuration

Before you run leveling you must edit elegoo_conf.ini /home/mks/Desktop/myfile/znp/znp_tjc_klipper/elegoo_conf.ini

Under [printer_offset]

z_offset                       = 0.00

Under [level_mode]

level_points                   = 6

This will ensure your G29 (from snippets) macro works; it will cause the Elegoo firmware to load the profile named 6 whenever it loads a profile.

This profile should represent the entire bed, do not use this name for adaptive meshing.

Step 3 - Update Moonraker

cd /home/mks/moonraker
git init
git remote add n4.moonraker https://git.krakjoe.dev/n4.moonraker.git
git fetch n4.moonraker n4/master
git reset --hard FETCH_HEAD
git pull n4.moonraker n4/master
./scripts/data-path-fix.sh

A note about data-path-fix.sh: This is a script that corrects all the open source Klipper and Moonraker pathing to Elegoo's requirements. If you update either Klipper or Mookraker using krakjoe work, its important to run this again.

Step 4 - Update Kiauh and Fluidd

Here is where I stopped trying to automate things. As it is Kiauh is already a nice tool why not use it?

cd /home/mks/kiauh

If it asks to update Kiauh, say yes. Run it again if needed. When you get to the menu you want to choose Update, and then Fluidd. If you update Klipper or Mookraker, you are getting the non-elegoo versions. It will overwrite all the work you have just done in steps 2 and 3.

image

The git errors are expected. This is the side effect of pulling Klipper and Moonraker down from another remote source.

image

Step 5 - Update Your Printer Configurations

TBD - lots of compare edit work

I automated some parts

  • moonraker.config