mirror of
https://github.com/bassamanator/Sovol-SV06-firmware.git
synced 2025-11-08 21:41:15 +00:00
Merge branch 'master' into any-printer. Many adjustments to readme.md.
This commit is contained in:
28
.github/ISSUE_TEMPLATE/bug_report.md
vendored
28
.github/ISSUE_TEMPLATE/bug_report.md
vendored
@@ -12,6 +12,7 @@ A clear and concise description of what the bug is.
|
|||||||
|
|
||||||
**To Reproduce**
|
**To Reproduce**
|
||||||
Steps to reproduce the behavior:
|
Steps to reproduce the behavior:
|
||||||
|
|
||||||
1. Go to '...'
|
1. Go to '...'
|
||||||
2. Click on '....'
|
2. Click on '....'
|
||||||
3. Scroll down to '....'
|
3. Scroll down to '....'
|
||||||
@@ -24,17 +25,38 @@ A clear and concise description of what you expected to happen.
|
|||||||
If applicable, add screenshots to help explain your problem.
|
If applicable, add screenshots to help explain your problem.
|
||||||
|
|
||||||
**What printer are you using?**
|
**What printer are you using?**
|
||||||
|
|
||||||
- SV06, SV06 Plus, etc.
|
- SV06, SV06 Plus, etc.
|
||||||
|
|
||||||
**What kind of device are you using to host Klipper?**
|
**What kind of device are you using to host Klipper?**
|
||||||
- OS: [e.g. old laptop, PC, Raspberry Pi]
|
|
||||||
- Version: []
|
- OS: [e.g. old laptop, PC, Raspberry Pi]
|
||||||
|
- Version: []
|
||||||
|
|
||||||
**How did you install Klipper?**
|
**How did you install Klipper?**
|
||||||
- Manual install, KIAUH, MainsailOS, FluiddPi, etc.
|
|
||||||
|
- Manual install, KIAUH, MainsailOS, FluiddPi, etc.
|
||||||
|
|
||||||
**Is your local copy of this configuration up to date?**
|
**Is your local copy of this configuration up to date?**
|
||||||
|
|
||||||
- This configuration changes all the time, when did you install it? Are you sure you're running the latest version?
|
- This configuration changes all the time, when did you install it? Are you sure you're running the latest version?
|
||||||
|
|
||||||
|
**What slicer are you using?**
|
||||||
|
|
||||||
|
- [ ] PrusaSlicer
|
||||||
|
- [ ] SuperSlicer
|
||||||
|
- [ ] Cura
|
||||||
|
- [ ] OrcaSlicer
|
||||||
|
|
||||||
|
**Are you using the config bundles from this repo?**
|
||||||
|
|
||||||
|
- [ ] Yes
|
||||||
|
- [ ] No
|
||||||
|
|
||||||
|
**Did you [Adjust your slicer](https://github.com/bassamanator/Sovol-SV06-firmware#adjust-your-slicer)**?
|
||||||
|
|
||||||
|
- [ ] Yes
|
||||||
|
- [ ] No
|
||||||
|
|
||||||
**Additional context**
|
**Additional context**
|
||||||
Add any other context about the problem here.
|
Add any other context about the problem here.
|
||||||
|
|||||||
243
README.md
243
README.md
@@ -1,6 +1,6 @@
|
|||||||
# 🚨 _One-Stop-Shop_ Klipper Configuration
|
# 🚨 _One-Stop-Shop_ Klipper Configuration
|
||||||
|
|
||||||
This branch contains the OSS Klipper configuration that can be used with **any printer** running Klipper.
|
This branch contains the OSS Klipper configuration that can be used with **any single-extruder printer** running Klipper. You must, however, have a working `printer.cfg`.
|
||||||
|
|
||||||
| Printer | Branch |
|
| Printer | Branch |
|
||||||
| ----------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- |
|
| ----------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- |
|
||||||
@@ -17,9 +17,12 @@ I am creating these files for my personal use and cannot be held responsible for
|
|||||||
- [Stay Up-to-Date](#stay-up-to-date)
|
- [Stay Up-to-Date](#stay-up-to-date)
|
||||||
- [Preface](#preface)
|
- [Preface](#preface)
|
||||||
- [Before You Begin](#before-you-begin)
|
- [Before You Begin](#before-you-begin)
|
||||||
- [Installation Steps](#installation-steps)
|
- [Klipper Installation](#klipper-installation)
|
||||||
- [Download OSS Klipper Configuration](#download-oss-klipper-configuration)
|
- [Download OSS Klipper Configuration](#download-oss-klipper-configuration)
|
||||||
- [Setup Instructions](#setup-instructions)
|
- [Setup Instructions](#setup-instructions)
|
||||||
|
- [Initial Steps](#initial-steps)
|
||||||
|
1. [Adjust Configuration with MCU Path](#adjust-configuration-with-mcu-path)
|
||||||
|
2. [Configure Your Printer](#configure-your-printer)
|
||||||
- [Adjust Your Slicer](#adjust-your-slicer)
|
- [Adjust Your Slicer](#adjust-your-slicer)
|
||||||
- [Support Me](#support-me)
|
- [Support Me](#support-me)
|
||||||
- [Directory Structure](#directory-structure)
|
- [Directory Structure](#directory-structure)
|
||||||
@@ -43,33 +46,48 @@ I am creating these files for my personal use and cannot be held responsible for
|
|||||||
- Load/unload filament macros.
|
- Load/unload filament macros.
|
||||||
- `PURGE_LINE` macro.
|
- `PURGE_LINE` macro.
|
||||||
- `TEST_SPEED` macro. Find instructions [here](#how-do-i-use-the-test_speed-macro).
|
- `TEST_SPEED` macro. Find instructions [here](#how-do-i-use-the-test_speed-macro).
|
||||||
- Klipper Adaptive Meshing & Purging (KAMP) integrated. Read about it [here](https://github.com/bassamanator/Sovol-SV06-firmware/tree/master#how-do-i-enable-kamp-klipper-adaptive-meshing--purging).
|
- Klipper Adaptive Meshing & Purging (KAMP) integrated. Read about it [here](#how-do-i-enable-kamp-klipper-adaptive-meshing--purging).
|
||||||
|
|
||||||
|
[🔼 Back to top](#outline)
|
||||||
|
|
||||||
## Stay Up-to-Date
|
## Stay Up-to-Date
|
||||||
|
|
||||||
⭐ ${\normalsize{\textcolor{goldenrod}{\texttt{Star this project}}}}$
|
${\normalsize{\textcolor{goldenrod}{\texttt{Star ⭐ this project}}}}$
|
||||||
|
|
||||||
Watch for releases and updates.
|
Watch for releases and updates. Please see this [discussion](https://github.com/bassamanator/Sovol-SV06-firmware/discussions/37).
|
||||||
|
|
||||||
<img src="./images/githubstar.gif" width="500" alt='github star'/>
|
<img src="./images/githubstar.gif" width="500" alt='github star'/>
|
||||||
|
|
||||||
|
[🔼 Back to top](#outline)
|
||||||
|
|
||||||
## Preface
|
## Preface
|
||||||
|
|
||||||
Although I've made switching over to Klipper as easy as is possible, it can still be a challenge for some, especially considering that most of you have likely never used GNU+Linux. Save yourself the frustration, and _fully read all the documentation on this page_. Also note that Klipper is not a _must_, and is not for everyone. You can stick with Marlin, and have a fine 3D printing experience.
|
Although I've made switching over to Klipper as easy as is possible, it can still be a challenge for some, especially considering that most of you have likely never used GNU+Linux. Save yourself the frustration, and _fully read all the documentation on this page_. Also note that Klipper is not a _must_, and is not for everyone. You can stick with Marlin, and have a fine 3D printing experience.
|
||||||
|
|
||||||
|
[🔼 Back to top](#outline)
|
||||||
|
|
||||||
## Before You Begin
|
## Before You Begin
|
||||||
|
|
||||||
- This entire page is a **6 minute read**. Save yourself _hours of troubleshooting_ and read this documentation fully.
|
- This entire page is a **12 minute read**. Save yourself _hours of troubleshooting_ and read this documentation fully.
|
||||||
- It is assumed that you already have a working `printer.cfg` and you already have your printer up and running Klipper.
|
- It is assumed that you already have a working `printer.cfg` and you already have your printer up and running Klipper.
|
||||||
- The [master](https://github.com/bassamanator/Sovol-SV06-firmware/tree/master) branch of this repo contains step by step instructions on how to get Klipper going. If you are a beginner, you might find those instructions useful.
|
- The [master](https://github.com/bassamanator/Sovol-SV06-firmware/tree/master) branch of this repo contains baby step by step instructions on how to get Klipper going for a particular bed printer (Sovol SV06). If you are a beginner, you might find those instructions useful.
|
||||||
- Make sure your printer is in good physical condition, because print and travel speeds will be _a lot faster_ than they were before. Beginner's would be wise to go through the steps mentioned [here](https://github.com/bassamanator/everything-sovol-sv06/blob/main/initialsteps.md). Consider yourself warned.
|
- Make sure your printer is in good physical condition, because print and travel speeds will be _a lot faster_ than they were before. Beginner's would be wise to go through the steps mentioned [here](https://github.com/bassamanator/everything-sovol-sv06/blob/main/initialsteps.md). Consider yourself warned.
|
||||||
|
- Follow the steps in order.
|
||||||
|
- If an error was reported at a step, do no proceed to the next step.
|
||||||
- It is assumed that you are connected to your host Raspberry Pi (or other host device) via SSH, and that your printer motherboard is connected to the host via a data USB cable. 💡 Most of the micro USB cables that you find at home are _unlikely_ to be data cables, and it's not possible to tell just by looking.
|
- It is assumed that you are connected to your host Raspberry Pi (or other host device) via SSH, and that your printer motherboard is connected to the host via a data USB cable. 💡 Most of the micro USB cables that you find at home are _unlikely_ to be data cables, and it's not possible to tell just by looking.
|
||||||
- [Disable](https://github.com/bassamanator/everything-sovol-sv06/blob/main/howto.md#disable-usb-cable-5v-pin) the USB cable's 5V pin.
|
- [Disable](https://github.com/bassamanator/everything-sovol-sv06/blob/main/howto.md#disable-usb-cable-5v-pin) the USB cable's 5V pin.
|
||||||
- It is also assumed that the username on the host device is `pi`. If that is not the case, you will have to manually edit `moonraker.conf` and `cfgs/misc-macros.cfg` and change any mentions of `/home/pi` to `/home/yourUserName`.
|
- It is also assumed that the username on the host device is `pi`. If that is not the case, you will have to manually edit `moonraker.conf` and `cfgs/misc-macros.cfg` and change any mentions of `/home/pi` to `/home/yourUserName`.
|
||||||
- Your question has probably been answered already, but if it hasn't, please post in the [Discussion](https://github.com/bassamanator/Sovol-SV06-firmware/discussions) section.
|
- Your question has probably been answered already, but if it hasn't, please post in the [Discussion](https://github.com/bassamanator/Sovol-SV06-firmware/discussions) section.
|
||||||
- I would recommend searching for the word `NOTE` in this repository. There are roughly half a dozen short points amongst the various files that you should be aware of if you're using this configuration.
|
- I would recommend searching for the word `NOTE` in this repository. There are roughly half a dozen short points amongst the various files that you should be aware of if you're using this configuration.
|
||||||
|
- You must have a `bed_mesh` for `PRINT_START` to work correctly. If you do not have probe to create a `bed_mesh`, simply comment out the line `BED_MESH_PROFILE LOAD=default` in the `PRINT_START` macro.
|
||||||
|
|
||||||
## Installation Steps
|
[🔼 Back to top](#outline)
|
||||||
|
|
||||||
|
## Klipper Installation
|
||||||
|
|
||||||
|
### Flash Firmware
|
||||||
|
|
||||||
|
You must flash your motherboard according to the manufacturer's instructions.
|
||||||
|
|
||||||
### Download OSS Klipper Configuration
|
### Download OSS Klipper Configuration
|
||||||
|
|
||||||
@@ -77,7 +95,9 @@ Although I've made switching over to Klipper as easy as is possible, it can stil
|
|||||||
2. The parent folder in the `ZIP` is `Sovol-SV06-firmware-any-printer`. This is relevant in the next step.
|
2. The parent folder in the `ZIP` is `Sovol-SV06-firmware-any-printer`. This is relevant in the next step.
|
||||||
3. Extract **only** the _contents_ of the parent folder into `~/printer_data/config`.
|
3. Extract **only** the _contents_ of the parent folder into `~/printer_data/config`.
|
||||||
|
|
||||||
💡 **If** you get a warning that you already have a `moonraker.conf` (which you probably do since you're already up and running Klipper), **and** you're not using a low powered device such as a Raspberry Pi Zero, you need to simply paste the following into your **existing** `moonraker.conf`:
|
See what files are necessary and which ones can be skipped [here](#directory-structure).
|
||||||
|
|
||||||
|
💡 **If** you get a warning that you already have a `moonraker.conf` **and if** you're _not_ using a low powered device such as a Raspberry Pi Zero, do not overwrite the _existing_ `moonraker.conf` and simply paste the following into it:
|
||||||
|
|
||||||
```yaml
|
```yaml
|
||||||
[file_manager]
|
[file_manager]
|
||||||
@@ -88,25 +108,104 @@ enable_object_processing: True
|
|||||||
|
|
||||||
Simply add `[include ./osskc.cfg]` somewhere at the top of your `printer.cfg`.
|
Simply add `[include ./osskc.cfg]` somewhere at the top of your `printer.cfg`.
|
||||||
|
|
||||||
|
[🔼 Back to top](#outline)
|
||||||
|
|
||||||
|
## Initial Steps
|
||||||
|
|
||||||
|
### Adjust Configuration with MCU Path
|
||||||
|
|
||||||
|
1. Find what port the `mcu` (printer motherboard) is connected to via **one** of the following commands:
|
||||||
|
|
||||||
|
- `ls /dev/serial/by-id/*`
|
||||||
|
- `ls /dev/serial/by-path/*`
|
||||||
|
|
||||||
|
1. The output will be something along the lines of
|
||||||
|
- `/dev/serial/by-id/usb-1a86_USB2.0-Serial-if00-port0`
|
||||||
|
|
||||||
|
2. Adjust the `[mcu]` section in `printer.cfg` accordingly.
|
||||||
|
|
||||||
|
```yaml
|
||||||
|
# 🗒️ This is just an example
|
||||||
|
[mcu]
|
||||||
|
serial: /dev/serial/by-id/usb-1a86_USB2.0-Serial-if00-port0
|
||||||
|
restart_method: command
|
||||||
|
```
|
||||||
|
|
||||||
|
3. Do a `FIRMWARE_RESTART`.
|
||||||
|
|
||||||
|
If the Klipper flash that you did earlier was successful, and you've done everything else correctly, you should see no errors or warnings in the Mainsail/Fluidd dashboard. **Klipper has successfully been installed on your printer!**
|
||||||
|
|
||||||
|
[🔼 Back to top](#outline)
|
||||||
|
|
||||||
|
### Configure Your Printer
|
||||||
|
|
||||||
|
❗☠️ **Your finger should be on the power switch for most of these steps** ☠️❗
|
||||||
|
|
||||||
|
❗☠️ **Power off if there is a collision/problem** ☠️❗
|
||||||
|
|
||||||
|
💡 The ${\small{\textcolor{red}{\texttt{EMERGENCY STOP}}}}$ button in your dashboard works faster than hitting the power switch.
|
||||||
|
|
||||||
|
💡 Do a practice emergency stop.
|
||||||
|
|
||||||
|
💡 I recommend no filament be loaded for any of these steps.
|
||||||
|
|
||||||
|
You will be pasting/typing these commands into the Mainsail/Fluidd console.
|
||||||
|
|
||||||
|
1. Check to see if `X` and `Y` max positions can be reached, and adjust `position_max`, if necessary. I recommend leaving a 2mm gap for safety.
|
||||||
|
1. `G28`
|
||||||
|
2. `G90`
|
||||||
|
3. `G1 X{insert_X_position_max_here} F3000`
|
||||||
|
4. `G1 Y{insert_Y_position_max_here} F3000`
|
||||||
|
2. _This step is optional_. Do a mechanical gantry calibration; `G34`. After the controlled collision against the beam at the top, there will be a 10 second pause for you to verify that both sides of the gantry are pressed up against the `stoppers` at the top. ~~You will hear a succession of beeps.~~
|
||||||
|
1. Figure out your `Z` `position_max` by baby stepping your way up to the beam, and adjust `position_max`, if necessary.
|
||||||
|
3. PID tune the bed. Ideally, all PID tuning should occur at the temperatures that you print most at.
|
||||||
|
1. `PID_TEST_BED TEMP=70`
|
||||||
|
2. `SAVE_CONFIG` (once completed)
|
||||||
|
4. PID tune the extruder while part cooling fan runs at 25%.
|
||||||
|
1. `PID_TEST_HOTEND TEMP=245`
|
||||||
|
2. `SAVE_CONFIG` (once completed)
|
||||||
|
5. Adjust `z_offset`. Make sure your nozzle if very clean. Do the [Paper test](https://www.klipper3d.org/Bed_Level.html?h=probe_calibrate#the-paper-test).
|
||||||
|
1. `DO_PROBE_CALIBRATE`
|
||||||
|
2. Follow `z_offset` setup in Mainsail/Fluidd.
|
||||||
|
3. `SAVE_CONFIG` (once completed)
|
||||||
|
6. _This step is optional_. Create a bed mesh.
|
||||||
|
1. `DO_CREATE_MESH`
|
||||||
|
2. `SAVE_CONFIG` (once completed)
|
||||||
|
|
||||||
|
🏁 If you've made it here, then your printer has been Klipperized, and is ready to print! 🏁
|
||||||
|
|
||||||
|
But first, adjust your slicer.
|
||||||
|
|
||||||
|
[🔼 Back to top](#outline)
|
||||||
|
|
||||||
## Adjust Your Slicer
|
## Adjust Your Slicer
|
||||||
|
|
||||||
💡 If you are using the config bundles found on this repo, you can skip this step.
|
💡 If you are using the config bundles found on this repo, you can skip this step.
|
||||||
|
|
||||||
You need to adjust the start and end gcode in your slicer. The relevant macros are `PRINT_START` and `PRINT_END`. Find instructions [here](https://ellis3dp.com/Print-Tuning-Guide/articles/passing_slicer_variables.html#slicer-start-g-code).
|
You need to adjust the start and end gcode in your slicer. The relevant macros are `PRINT_START` and `PRINT_END`. Find instructions [here](https://ellis3dp.com/Print-Tuning-Guide/articles/passing_slicer_variables.html#slicer-start-g-code).
|
||||||
|
|
||||||
If you would like to print a purge line before your print starts, at the end of your start gcode, on a new line add `PURGE_LINE`.
|
### Line Purge
|
||||||
|
|
||||||
|
If you would like to print a purge line before your print starts, at the end of your start gcode, on a new line, add one of the following:
|
||||||
|
|
||||||
|
- `PURGE_LINE`; prints a standard purge line.
|
||||||
|
- `LINE_PURGE`; prints KAMP's purge line. ⚠️ Do not attempt to use without reading [this section](#how-do-i-enable-kamp-klipper-adaptive-meshing--purging).
|
||||||
|
|
||||||
```yaml
|
```yaml
|
||||||
# 🗒️ This is just an example
|
# 🗒️ This is just an example Start G-Code
|
||||||
PRINT_START ...
|
PRINT_START ...
|
||||||
PURGE_LINE
|
PURGE_LINE
|
||||||
```
|
```
|
||||||
|
|
||||||
|
[🔼 Back to top](#outline)
|
||||||
|
|
||||||
## Support Me
|
## Support Me
|
||||||
|
|
||||||
Please ⭐ star this repository!
|
Please ⭐ star this repository!
|
||||||
|
|
||||||
If you found my work useful, consider buying me a [<img src="./images/logo_white_stroke.png" height="20" alt='Ko-fi'/>](https://ko-fi.com/bassamanator).
|
If you found my work useful, buy me a [<img src="./images/logo_white_stroke.png" height="20" alt='Ko-fi'/>](https://ko-fi.com/bassamanator).
|
||||||
|
|
||||||
|
[🔼 Back to top](#outline)
|
||||||
|
|
||||||
## Directory Structure
|
## Directory Structure
|
||||||
|
|
||||||
@@ -125,16 +224,126 @@ This repository contains many files and folders. Some are _necessary_ for this K
|
|||||||
├── images/ ❌
|
├── images/ ❌
|
||||||
├── LICENSE ❌
|
├── LICENSE ❌
|
||||||
├── misc/ ❌
|
├── misc/ ❌
|
||||||
├── moonraker.conf ✅
|
├── moonraker.conf ✅ ❔
|
||||||
├── osskc.cfg ✅
|
├── osskc.cfg ✅
|
||||||
├── README.md ❌
|
├── README.md ❌
|
||||||
├── SECURITY.md ❌
|
├── SECURITY.md ❌
|
||||||
└── .vscode/ ❌
|
└── .vscode/ ❌
|
||||||
```
|
```
|
||||||
|
|
||||||
|
[🔼 Back to top](#outline)
|
||||||
|
|
||||||
## FAQ
|
## FAQ
|
||||||
|
|
||||||
Please find answers to common questions [here](https://github.com/bassamanator/Sovol-SV06-firmware/blob/master/README.md#faq).
|
### How do I import a configuration bundle into SuperSlicer/PrusaSlicer?
|
||||||
|
|
||||||
|
Please see this [discussion](https://github.com/bassamanator/Sovol-SV06-firmware/discussions/13).
|
||||||
|
|
||||||
|
### How do I print using SuperSlicer?
|
||||||
|
|
||||||
|
Please see this [discussion](https://github.com/bassamanator/Sovol-SV06-firmware/discussions/14).
|
||||||
|
|
||||||
|
### When does beeping occur?
|
||||||
|
|
||||||
|
The printer will beep upon:
|
||||||
|
|
||||||
|
- Filament runout.
|
||||||
|
- Filament change/`M600`.
|
||||||
|
- Upon `PRINT_END`.
|
||||||
|
- `MECHANICAL_GANTRY_CALIBRATION`/`G34`.
|
||||||
|
|
||||||
|
Adjust behaviour according to your needs.
|
||||||
|
|
||||||
|
| File | `cfgs/misc-macros.cfg` |
|
||||||
|
| -------- | -------------------------- |
|
||||||
|
| Section | `[gcode_macro _globals]` |
|
||||||
|
| Variable | `variable_beeping_enabled` |
|
||||||
|
| Disable | `0` |
|
||||||
|
| Enable | `1` (default) |
|
||||||
|
|
||||||
|
### I want to use a filament sensor. How do I set it up?
|
||||||
|
|
||||||
|
You can find information about the physical setup [here](https://github.com/bassamanator/everything-sovol-sv06#filament-sensor).
|
||||||
|
|
||||||
|
Adjust behaviour according to your needs.
|
||||||
|
|
||||||
|
| File | `cfgs/misc-macros.cfg` |
|
||||||
|
| -------- | ---------------------------------- |
|
||||||
|
| Section | `[gcode_macro _globals]` |
|
||||||
|
| Variable | `variable_filament_sensor_enabled` |
|
||||||
|
| Disable | `0` (default) |
|
||||||
|
| Enable | `1` |
|
||||||
|
|
||||||
|
### My filament runout sensor works, but I just started a print without any filament loaded. What gives?
|
||||||
|
|
||||||
|
A simple runout sensor can only detect a change in state. So, if you start a print without filament loaded, the printer will not know that there is no filament loaded. You should test your sensor by having filament loaded, starting a print, then cutting the filament. The expected behaviour is that the print will pause, and as long as you have beeping enabled, you will hear 3 annoying beeps.
|
||||||
|
|
||||||
|
### What happens when I put in `M600`/colour change at a certain layer?
|
||||||
|
|
||||||
|
1. The printer will beep 3 times (not annoyingly).
|
||||||
|
2. Printing will stop.
|
||||||
|
3. The printhead will park itself front center.
|
||||||
|
4. The hotend will turn off, but the bed will remain hot.
|
||||||
|
|
||||||
|
### What happens when I pause a print?
|
||||||
|
|
||||||
|
Same behaviour as `M600`/colour change _except_ there won't be any beeping.
|
||||||
|
|
||||||
|
### What happens when filament runs out?
|
||||||
|
|
||||||
|
_If_ you have a working filament sensor, the same behaviour as `M600`/colour change will occur _except_ the beeps will be fairly annoying.
|
||||||
|
|
||||||
|
### How do I resume a print after a colour change or filament runout?
|
||||||
|
|
||||||
|
⚠️ Do not disable the stepper motors during this process!
|
||||||
|
|
||||||
|
The printhead is now parked front center waiting for you to insert filament. You will:
|
||||||
|
|
||||||
|
1. Heat up the hotend to the desired temperature.
|
||||||
|
- Use your Klipper dashboard.
|
||||||
|
2. Purge (push) some filament through the nozzle.
|
||||||
|
- Use your Klipper dashboard, and extrude maybe 50mm (for a colour change you probably want to extrude more).
|
||||||
|
- OR, you can push some filament by hand _making sure to first disengage the extruder's spring loaded arm_.
|
||||||
|
3. Hit resume in your Klipper dashboard.
|
||||||
|
|
||||||
|
### How do I enable KAMP (Klipper Adaptive Meshing & Purging)?
|
||||||
|
|
||||||
|
⚠️ No KAMP functionality can be used on low-powered devices such as the Raspberry Pi Zero.
|
||||||
|
|
||||||
|
⚠️ If KAMP is disabled, and there is no `default` mesh, `PRINT_START` will crash.
|
||||||
|
|
||||||
|
🗒️ The [Label objects setting](https://docs.mainsail.xyz/overview/features/exclude-objects#enable-the-label-objects-setting-in-your-slicer) in your slicer must be enabled for KAMP to work.
|
||||||
|
|
||||||
|
🗒️ `LINE_PURGE` is useable (on appropriate devices) even if KAMP is disabled.
|
||||||
|
|
||||||
|
This repo contains all the code from the KAMP repository, however, only the `adaptive meshing` and `LINE_PURGE` functionality of KAMP has been configured and tested for use. To enable other functionality, adjust `/cfgs/kamp/KAMP_Settings.cfg`.
|
||||||
|
|
||||||
|
Adjust behaviour according to your needs.
|
||||||
|
|
||||||
|
| File | `cfgs/misc-macros.cfg` |
|
||||||
|
| -------- | ------------------------ |
|
||||||
|
| Section | `[gcode_macro _globals]` |
|
||||||
|
| Variable | `variable_kamp_enable` |
|
||||||
|
| Disable | `0` (default) |
|
||||||
|
| Enable | `1` |
|
||||||
|
|
||||||
|
### How do I use the `TEST_SPEED` macro?
|
||||||
|
|
||||||
|
⚠️ This is for advanced users only, with well oiled machines. You can cause serious damage to your printer if you're not careful. ☠️ **You have been warned** ☠️.
|
||||||
|
|
||||||
|
Find full instructions [here](https://ellis3dp.com/Print-Tuning-Guide/articles/determining_max_speeds_accels.html).
|
||||||
|
|
||||||
|
Some tips:
|
||||||
|
|
||||||
|
- Before running with `ITERATIONS=40` with an untested speed/accel value, run with `ITERATIONS=1`.
|
||||||
|
- Pay close attention throughout the run, so that you can click ${\small{\textcolor{red}{\texttt{EMERGENCY STOP}}}}$ at a moment's notice.
|
||||||
|
- This macro will simply help you determine the maximum speed your printhead and bed can reliably move at, not necessarily print at. The bottleneck for my SV06, for example, is the 15mm/s^2 that the hotend maxes out at (well under 200mm/s actual print speed).
|
||||||
|
|
||||||
|
### How do I compile my own firmware?
|
||||||
|
|
||||||
|
Please see this [discussion](https://github.com/bassamanator/Sovol-SV06-firmware/discussions/111).
|
||||||
|
|
||||||
|
[🔼 Back to top](#outline)
|
||||||
|
|
||||||
## Useful Resources
|
## Useful Resources
|
||||||
|
|
||||||
@@ -143,12 +352,16 @@ Please find answers to common questions [here](https://github.com/bassamanator/S
|
|||||||
- ⭐⭐⭐⭐⭐ [Ellis' Print Tuning Guide](https://ellis3dp.com/Print-Tuning-Guide)
|
- ⭐⭐⭐⭐⭐ [Ellis' Print Tuning Guide](https://ellis3dp.com/Print-Tuning-Guide)
|
||||||
- [Simplify3D Print Quality Troubleshooting Guide](https://www.simplify3d.com/resources/print-quality-troubleshooting/)
|
- [Simplify3D Print Quality Troubleshooting Guide](https://www.simplify3d.com/resources/print-quality-troubleshooting/)
|
||||||
|
|
||||||
|
[🔼 Back to top](#outline)
|
||||||
|
|
||||||
## Sovol Official Links
|
## Sovol Official Links
|
||||||
|
|
||||||
- [SV06 Marlin Source Code](https://github.com/Sovol3d/Sv06-Source-Code)
|
- [SV06 Marlin Source Code](https://github.com/Sovol3d/Sv06-Source-Code)
|
||||||
- [SV06 Models](https://github.com/Sovol3d/SV06-Fully-Open-Source)
|
- [SV06 Models](https://github.com/Sovol3d/SV06-Fully-Open-Source)
|
||||||
- [SV06 Plus Marlin Source Code and Models](https://github.com/Sovol3d/SV06-PLUS)
|
- [SV06 Plus Marlin Source Code and Models](https://github.com/Sovol3d/SV06-PLUS)
|
||||||
|
|
||||||
|
[🔼 Back to top](#outline)
|
||||||
|
|
||||||
## Sources
|
## Sources
|
||||||
|
|
||||||
- [https://www.klipper3d.org](https://www.klipper3d.org)
|
- [https://www.klipper3d.org](https://www.klipper3d.org)
|
||||||
@@ -161,3 +374,5 @@ Please find answers to common questions [here](https://github.com/bassamanator/S
|
|||||||
- [PrusaSlicer Print Settings](https://github.com/mjonuschat/PrusaSlicer-Profiles)
|
- [PrusaSlicer Print Settings](https://github.com/mjonuschat/PrusaSlicer-Profiles)
|
||||||
|
|
||||||
[](https://ko-fi.com/H2H0HIHTH)
|
[](https://ko-fi.com/H2H0HIHTH)
|
||||||
|
|
||||||
|
[🔼 Back to top](#outline)
|
||||||
|
|||||||
@@ -2,7 +2,7 @@
|
|||||||
|
|
||||||
# NOTE bassamanator: uncomment the functionality that you want to use from KAMP
|
# NOTE bassamanator: uncomment the functionality that you want to use from KAMP
|
||||||
[include ./Adaptive_Meshing.cfg] # Include to enable adaptive meshing configuration.
|
[include ./Adaptive_Meshing.cfg] # Include to enable adaptive meshing configuration.
|
||||||
# [include ./Line_Purge.cfg] # Include to enable adaptive line purging configuration.
|
[include ./Line_Purge.cfg] # Include to enable adaptive line purging configuration.
|
||||||
# [include ./Voron_Purge.cfg] # Include to enable adaptive Voron logo purging configuration.
|
# [include ./Voron_Purge.cfg] # Include to enable adaptive Voron logo purging configuration.
|
||||||
# [include ./Smart_Park.cfg] # Include to enable the Smart Park function, which parks the printhead near the print area for final heating.
|
# [include ./Smart_Park.cfg] # Include to enable the Smart Park function, which parks the printhead near the print area for final heating.
|
||||||
|
|
||||||
|
|||||||
BIN
images/make-menuconfig.png
Normal file
BIN
images/make-menuconfig.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 72 KiB |
43
misc/compile-how-to.md
Normal file
43
misc/compile-how-to.md
Normal file
@@ -0,0 +1,43 @@
|
|||||||
|
${\small{\textcolor{green}{\texttt{2 minute read}}}}$
|
||||||
|
|
||||||
|
#### Do I need to re-flash the motherboard?
|
||||||
|
|
||||||
|
You will _almost never_ need to re-flash `klipper.bin`. When this is needed, your dashboard will explicitly tell you that you need to re-flash.
|
||||||
|
|
||||||
|
#### Where does Klipper live?
|
||||||
|
|
||||||
|
1. On the motherboard.
|
||||||
|
2. On the host device (Raspberry Pi, etc.).
|
||||||
|
|
||||||
|
🗒️ These 2 versions of klipper can rightly differ.
|
||||||
|
|
||||||
|
#### Should I update Klipper, moonraker, etc.?
|
||||||
|
|
||||||
|
I always update everything on the host device via the dashboard. I don't want to miss out on improvements, especially those that improve safety. What this means is that on some occasions, there will be breaking changes: you will need to change a few things in your config **before you can print**. I would suggest that if you absolutely have to get something printed immediately and there's an update, perhaps wait till after the print completes to do the update.
|
||||||
|
|
||||||
|
Others will argue that 'if it ain't broke, don't fix it'.
|
||||||
|
|
||||||
|
You have to decide what camp you want to be apart off.
|
||||||
|
|
||||||
|
#### How-To
|
||||||
|
|
||||||
|
##### Update Klipper repo first
|
||||||
|
|
||||||
|
It's always best to update the Klipper repository that lives on the host before compiling. This ensures that your `klipper.bin` will be as 'fresh' as possible.
|
||||||
|
|
||||||
|
- In `Fluidd`, you can do this from `Settings` > `Software Updates`.
|
||||||
|
- In `Mainsail`, you can do this from `Machine` > `Update Manager`.
|
||||||
|
|
||||||
|
##### Compile `klipper.bin`
|
||||||
|
|
||||||
|
🗒️ The `compilation settings` you see in the image below apply only the the `SV06/Plus` boards, but the steps for compilation apply to any board.
|
||||||
|
|
||||||
|
1. `ssh` into the Klipper host (i.e., RPi, OrangePi, etc.).
|
||||||
|
2. `cd ~/klipper`
|
||||||
|
3. `make menuconfig`
|
||||||
|
4. Set things up to look as follows:
|
||||||
|

|
||||||
|
5. `make clean`
|
||||||
|
- Clears `~/klipper/out/`
|
||||||
|
6. `make`
|
||||||
|
- Compiles `klipper.bin` and puts it in `~/klipper/out/`
|
||||||
73
misc/update-hot-to.md
Normal file
73
misc/update-hot-to.md
Normal file
@@ -0,0 +1,73 @@
|
|||||||
|
\*\* _Flashing the firmware is not required for any method_
|
||||||
|
|
||||||
|
## Should You Update?
|
||||||
|
|
||||||
|
I treat this config like software, and like any piece of modern software, it will require periodic updates to fix issues, add features, improve functionality, etc. So, if you want to have the latest and greatest, I recommend you periodically pull the changes from this repo.
|
||||||
|
|
||||||
|
### What Changes Should You Be Concerned With
|
||||||
|
|
||||||
|
The only changes you need to be concerned with relate to the `.cfg` and `.conf` files; all changes to `.md` files (these are markdown files, the text that you see when you visit this repo) can be ignored.
|
||||||
|
|
||||||
|
### Git Users
|
||||||
|
|
||||||
|
If you do a `git diff origin/master --name-only` and it shows you that a `.cfg` file has changed, you might want to pull in those changes (but you don't have to).
|
||||||
|
|
||||||
|
### Non-Git Users
|
||||||
|
|
||||||
|
Unfortunately, there's no simple way for you to ascertain whether there have been changes. I simply recommend that you update your config via the instructions below from time to time.
|
||||||
|
|
||||||
|
## Hot to Update
|
||||||
|
|
||||||
|
There are three methods to accomplish this:
|
||||||
|
|
||||||
|
1. The correct method, using `git`.
|
||||||
|
2. The mostly acceptable method, without using `git`.
|
||||||
|
3. The start-from-scratch method. _Recommended for non-git users and those who haven't made many changes to their configuration._
|
||||||
|
|
||||||
|
### The `git` method.
|
||||||
|
|
||||||
|
⚠️ This method is only intended for those who already know how to use `git`.
|
||||||
|
|
||||||
|
🗒️ In this example, I'm using the `master` branch which applies to SV06 users only. Be sure to use the appropriate branch for your printer.
|
||||||
|
|
||||||
|
🗒️ The assumption is that you didn't change branches after the initial setup, so you are in `master`, and there are many untracked changes.
|
||||||
|
|
||||||
|
1. `ssh` into your Klipper host.
|
||||||
|
2. `cd ~/printer_data/config`
|
||||||
|
3. `git checkout -b my-settings`
|
||||||
|
4. `git add .`
|
||||||
|
5. `git commit -m "Saving my settings."`
|
||||||
|
6. `git checkout master`
|
||||||
|
7. `git pull`
|
||||||
|
8. `git checkout my-settings`
|
||||||
|
9. `git merge master --no-ff --no-commit`
|
||||||
|
10. Deal with comparing and pulling in incoming changes from `master` using your favourite code editor. You can also do this from the command line via `git commit --interactive`, however, only advanced `git` users should attempt this, though it is easy enough.
|
||||||
|
11. Add all welcomed changes to the staging area, and discard all other changes.
|
||||||
|
12. `git commit -m "Update with upstream."`
|
||||||
|
|
||||||
|
You should push your branch to your own fork of this repo.
|
||||||
|
|
||||||
|
For any future updates, you can run through the same process again, however, you cannot re-create the `my-settings` branch as you did in `step 3`, because it already exists. Simply omit the `-b` flag in `step 3` next time you update.
|
||||||
|
|
||||||
|
### The mostly acceptable method.
|
||||||
|
|
||||||
|
This method has shortcomings, because it relies on the user's memory, and requires more manual edits. Perfectly functional method, however.
|
||||||
|
|
||||||
|
1. Read all the documentation.
|
||||||
|
2. Backup your current configuration, essentially everything inside `~/printer_data/config`.
|
||||||
|
3. Repeat steps in [Download OSS Klipper Configuration](https://github.com/bassamanator/Sovol-SV06-firmware#download-oss-klipper-configuration), and [Adjust Configuration with MCU Path](https://github.com/bassamanator/Sovol-SV06-firmware#adjust-configuration-with-mcu-path).
|
||||||
|
4. Copy everything from `#*# <---------------------- SAVE_CONFIG ---------------------->` onward and paste into new `printer.cfg`, inclusive.
|
||||||
|
5. Copy any other changes you might have made into the new configuration. Maybe you had adjusted the size of your printer (`position_max`), or other such changes.
|
||||||
|
|
||||||
|
### The start-from-scratch method.
|
||||||
|
|
||||||
|
1. Delete the folder `~/printer_data/config`.
|
||||||
|
2. Recreate the folder `~/printer_data/config` via `mkdir ~/printer_data/config`.
|
||||||
|
3. Start the Klipper installation process starting from `Download OSS Klipper Configuration` in the appropriate branch.
|
||||||
|
|
||||||
|
## Linux Tips
|
||||||
|
|
||||||
|
- In linux, you can delete files via `rm fileName` and directories via `rmdir directoryName`.
|
||||||
|
- In linux, you can list files and folders via `ls -lah`.
|
||||||
|
|
||||||
|
You are now up-to-date with this repo, and have added your personal settings on top.
|
||||||
Reference in New Issue
Block a user