K2 Improvements

DISCLAIMER

Use at your own risk, I'm not responsible for fires or broken dreams. But you do get to keep both halves if something breaks.

Warning

As a heads up these improvements are not compatible with Creality's auto-calibration. In our experience we get better results through manual tuning.

Start Here at Bootstrap

The Bootstrap is a requirement for the improvements to install properly, so this must be accomplished first. Of note, it will install entware tools necessary to accomplish the installs.

1. Enable root access on the K2 Plus by going to Settings, General tab and root on the physical screen. Take note of the password.
2. Download bootstrap https://github.com/jamincollins/k2-improvements/releases/tag/bootstrap and extract the folder.
3. To install the bootstrap, connect to your K2 Plus's Fluid interface via browser http://PrinterIP:4408
4. Unzip the downloaded bootstrap folder and upload the extracted bootstrap folder by going to Configuration {...}, +, Upload Folder, and selecting the extracted bootstrap folder.
5. SSH to the K2 Plus using any terminal tool (e.g. PuTTy) using the printers ip adress, port 22, user "root" and the password noted in step 1.
6. Recommend performing a wipe prior to install due to potential conflicts with previous mods enter the command 'echo "all" | /usr/bin/nc -U /var/run/wipe.sock' into your terminal.
7. If you execute a wipe, you will need to go through setup on the K2 screen and complete all the way through creality cloud connection. This will give you the wifi/network connection that you will need and connect appropriately to creality cloud. Stop at the calibration, you can do this later.
8. To start the boostrap install paste into the terminal sh /mnt/UDISK/printer_data/config/bootstrap/bootstrap.sh and hit enter.

Installers

A unified installation menu is planned. For now each feature can be found under the features directory. A README.md and installation script install.sh are provided for each option.

The unified installer will understand inter option dependencies and ensure they are met.

For now, there are two default installations:

• gimme-the-jamin.sh - Used to install carto NOTE MUST HAVE CARTO FLASHED AND PLUGGED IN AND READY TO GO by following instructions here

To run use the terminal command sh /mnt/UDISK/root/k2-improvements/gimme-the-jamin.sh

• no-carto.sh - Use this if you aren't going to use a carto, or don't have your carto yet.

To run use the terminal command sh /mnt/UDISK/root/k2-improvements/no-carto.sh

They both install the same set of features (those that I use). The only difference is whether or not the cartographer bits are installed. If you start with no-carto.sh and later get a carto, you can then run the gimme-the-jamin.sh script and it will install all of the necessary carto items appropriately.

You are still welcome to hand pick which features you want to install.

Donations

Donations are definitely not required, they are appreciated. If you'd like to donate you can do so here.

Features

• axis_twist_compensation
• better init
• better root home directory
• Cartographer support
• installs Entware
• updated Fluidd
• updated Moonraker
• Obico - WIP
• implements SCREWS_TILT_CALCULATE

And a few quality of life improvement macros

• MESH_IF_NEEDED
• START_PRINT
• M191

Bed Leveling

Sadly, many of the K2 beds resemble a taco or valley. In the bed_leveling folder you will find a python based script and short writeup on how to apply aluminium tape to shim the bed.

Credits

• @Guilouz - standing on the shoulders of giants

• @stranula

• @juliosueiras

• Moonraker - https://github.com/Arksine/moonraker

• Klipper - https://github.com/Klipper3d/klipper

• Fluidd - https://github.com/fluidd-core/fluidd

• Entware - https://github.com/Entware/Entware

• Obico - https://www.obico.io/

FAQ

See the FAQ