Add Moonraker Update Manager integration
🎉 One-click updates from Mainsail/Fluidd UI! New files: - moonraker/update_manager.cfg - Moonraker config - moonraker/README.md - Setup instructions - install.sh - Auto-install/update script - README.md - Complete project documentation Features: ✅ Update Manager entry in Mainsail/Fluidd ✅ One-click updates from web UI ✅ Automatic Klipper restart after update ✅ Safe install (doesn't overwrite custom user_settings.cfg) ✅ Installs calibration macros automatically ✅ Professional update workflow Setup: 1. Add [include open4neptune-new/moonraker/update_manager.cfg] to moonraker.conf 2. Restart Moonraker 3. Machine → Update Manager → open4neptune-configs → Update Like official Klipper plugins! 🔥
This commit is contained in:
root
parent
862b062ecb
commit
8dba9d6b55
4 changed files with 631 additions and 0 deletions
267
README.md
Normal file
267
README.md
Normal file
|
|
@ -0,0 +1,267 @@
|
|||
# 🎯 Neptune 4 Plus - Open4Neptune Configs
|
||||
|
||||
Complete Klipper configuration for Elegoo Neptune 4 Plus with Cartographer 3D, optimized for both Original and Bambu Lab hotends.
|
||||
|
||||
---
|
||||
|
||||
## 🚀 Quick Start
|
||||
|
||||
### 1. Clone Repository
|
||||
|
||||
```bash
|
||||
cd ~/printer_data/config
|
||||
git clone https://git.sky-net.it/nocci/open4neptune-new.git
|
||||
```
|
||||
|
||||
### 2. Install Update Manager (Optional but Recommended!)
|
||||
|
||||
Add to your `moonraker.conf`:
|
||||
|
||||
```ini
|
||||
[include open4neptune-new/moonraker/update_manager.cfg]
|
||||
```
|
||||
|
||||
Restart Moonraker, then update directly from Mainsail/Fluidd UI! 🎉
|
||||
|
||||
### 3. Install Configs
|
||||
|
||||
```bash
|
||||
# Copy calibration macros
|
||||
cp -r open4neptune-new/calibration/ ~/printer_data/config/
|
||||
|
||||
# Copy user settings (choose one):
|
||||
cp open4neptune-new/user_settings_clean.cfg ~/printer_data/config/user_settings.cfg
|
||||
```
|
||||
|
||||
### 4. Restart Klipper
|
||||
|
||||
**Mainsail/Fluidd:** Machine → Restart Firmware
|
||||
|
||||
---
|
||||
|
||||
## ✨ Features
|
||||
|
||||
### 🔧 PRINT_START Macro
|
||||
- ✅ Cartographer Z0 calibration
|
||||
- ✅ Automatic bed mesh (adaptive)
|
||||
- ✅ Nozzle cleaning (KNCM)
|
||||
- ✅ Precise temperature control (±2°C)
|
||||
- ✅ Smart homing (CG28)
|
||||
|
||||
### 🎯 PRINT_END Macro
|
||||
- ✅ Detailed user feedback
|
||||
- ✅ Auto park position
|
||||
- ✅ Disable motors & sensors
|
||||
- ✅ Completion jingle (END_TUNE)
|
||||
|
||||
### 📊 Calibration Suite
|
||||
- `CALIBRATE_Z_OFFSET` - Cartographer Z0
|
||||
- `CALIBRATE_INPUT_SHAPER` - ADXL resonance
|
||||
- `CALIBRATE_PRESSURE_ADVANCE` - PA tuning
|
||||
- `CALIBRATE_FLOW_RATE` - Flow calibration
|
||||
- `CALIBRATE_TEMPERATURE` - Temp tower
|
||||
- `CALIBRATE_RETRACTION` - Retraction test
|
||||
- `CALIBRATE_BED_MESH` - Bed mesh
|
||||
- `CALIBRATION_FULL` - Complete suite (~2.5h)
|
||||
- `CALIBRATION_QUICK` - Essential only (~30min)
|
||||
|
||||
### 🎨 Orca Slicer Profiles
|
||||
- ✅ 10 profiles for both hotends
|
||||
- ✅ PLA, PETG, ABS, TPU, Carbon Fiber
|
||||
- ✅ Optimized for 15 mm³/s (Original) & 23 mm³/s (Bambu)
|
||||
|
||||
---
|
||||
|
||||
## 📁 Repository Structure
|
||||
|
||||
```
|
||||
open4neptune-new/
|
||||
├── moonraker/
|
||||
│ ├── update_manager.cfg # Moonraker Update Manager config
|
||||
│ └── README.md # Setup instructions
|
||||
├── calibration/
|
||||
│ ├── CALIBRATION_GUIDE.md # Step-by-step guide
|
||||
│ ├── calibration_macros.cfg # All calibration macros
|
||||
│ └── test_patterns.cfg # Printable test patterns
|
||||
├── orca-profiles/
|
||||
│ ├── Neptune4Plus-Original/ # 15 mm³/s hotend
|
||||
│ ├── Neptune4Plus-Bambu/ # 23 mm³/s hotend
|
||||
│ └── README.md # Profile documentation
|
||||
├── user_settings_clean.cfg # Production-ready config
|
||||
├── user_settings_optimized.cfg # Verbose config (with comments)
|
||||
├── install.sh # Install/update script
|
||||
├── CHANGES.md # Change log
|
||||
├── CLEANUP_NOTES.md # Cleanup documentation
|
||||
└── README.md # This file
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🔧 Installation Options
|
||||
|
||||
### Option A: Moonraker Update Manager (Recommended!)
|
||||
|
||||
**One-time setup:**
|
||||
|
||||
```bash
|
||||
# 1. Clone repo
|
||||
cd ~/printer_data/config
|
||||
git clone https://git.sky-net.it/nocci/open4neptune-new.git
|
||||
|
||||
# 2. Add to moonraker.conf
|
||||
echo "[include open4neptune-new/moonraker/update_manager.cfg]" >> ~/printer_data/config/moonraker.conf
|
||||
|
||||
# 3. Make install script executable
|
||||
chmod +x ~/printer_data/config/open4neptune-new/install.sh
|
||||
|
||||
# 4. Restart Moonraker
|
||||
sudo systemctl restart moonraker
|
||||
```
|
||||
|
||||
**Then:** Machine → Update Manager → "open4neptune-configs" → Update
|
||||
|
||||
### Option B: Manual Installation
|
||||
|
||||
```bash
|
||||
cd ~/printer_data/config
|
||||
git clone https://git.sky-net.it/nocci/open4neptune-new.git
|
||||
cp -r open4neptune-new/calibration/ ~/printer_data/config/
|
||||
cp open4neptune-new/user_settings_clean.cfg ~/printer_data/config/user_settings.cfg
|
||||
# Restart Klipper
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🎯 Usage
|
||||
|
||||
### In Slicer (Orca/PrusaSlicer/Cura):
|
||||
|
||||
**Start Gcode:**
|
||||
```gcode
|
||||
PRINT_START EXTRUDER_TEMP=[nozzle_temperature] BED_TEMP=[bed_temperature] FILAMENT_TYPE=PLA
|
||||
```
|
||||
|
||||
**End Gcode:**
|
||||
```gcode
|
||||
PRINT_END
|
||||
```
|
||||
|
||||
### In Mainsail/Fluidd Console:
|
||||
|
||||
```gcode
|
||||
; Show calibration menu
|
||||
CALIBRATION_MENU
|
||||
|
||||
; Quick Z measurement
|
||||
QUICK_TOUCH
|
||||
|
||||
; Babysteps during print
|
||||
BABYZ_PLUS ; Z +0.005mm
|
||||
BABYZ_MINUS ; Z -0.005mm
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 📊 Orca Profile Installation
|
||||
|
||||
1. Open Orca Slicer
|
||||
2. File → Import → Import Config(s)...
|
||||
3. Select profiles from `orca-profiles/` folder
|
||||
4. Choose profile based on your hotend:
|
||||
- **Original:** `Neptune4Plus-Original/*`
|
||||
- **Bambu:** `Neptune4Plus-Bambu/*`
|
||||
|
||||
---
|
||||
|
||||
## 🔍 Troubleshooting
|
||||
|
||||
### Calibration Macros Not Found
|
||||
|
||||
```bash
|
||||
# Check if calibration folder exists
|
||||
ls ~/printer_data/config/calibration/
|
||||
|
||||
# Check if included in printer.cfg
|
||||
grep "calibration" ~/printer_data/config/printer.cfg
|
||||
```
|
||||
|
||||
### Update Manager Not Showing
|
||||
|
||||
```bash
|
||||
# Check moonraker.conf
|
||||
grep "open4neptune" ~/printer_data/config/moonraker.conf
|
||||
|
||||
# Restart Moonraker
|
||||
sudo systemctl restart moonraker
|
||||
|
||||
# Check logs
|
||||
journalctl -u moonraker -f
|
||||
```
|
||||
|
||||
### PRINT_START Not Working
|
||||
|
||||
```gcode
|
||||
; Test in console
|
||||
PRINT_START EXTRUDER_TEMP=200 BED_TEMP=60
|
||||
|
||||
; Check for errors in Klipper console
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 📖 Documentation
|
||||
|
||||
- **CALIBRATION_GUIDE.md** - Complete calibration instructions
|
||||
- **moonraker/README.md** - Update Manager setup
|
||||
- **orca-profiles/README.md** - Orca profile guide
|
||||
- **CHANGES.md** - Recent changes
|
||||
- **CLEANUP_NOTES.md** - Cleanup documentation
|
||||
|
||||
---
|
||||
|
||||
## 🎉 Features at a Glance
|
||||
|
||||
| Feature | Status | Description |
|
||||
|---------|--------|-------------|
|
||||
| PRINT_START | ✅ | Cartographer Z0, bed mesh, nozzle clean |
|
||||
| PRINT_END | ✅ | Auto park, motors off, completion jingle |
|
||||
| Calibration Suite | ✅ | 7 calibration macros + test patterns |
|
||||
| Moonraker Update | ✅ | One-click updates from Mainsail UI |
|
||||
| Orca Profiles | ✅ | 10 profiles for 2 hotends |
|
||||
| KNCM Integration | ✅ | Nozzle cleaning macros |
|
||||
| Helper Macros | ✅ | QUICK_TOUCH, BABYZ_±, CALIBRATE_PROBE |
|
||||
|
||||
---
|
||||
|
||||
## 🚨 Important Notes
|
||||
|
||||
⚠️ **Always backup before updates:**
|
||||
```bash
|
||||
cp ~/printer_data/config/user_settings.cfg ~/printer_data/config/user_settings.cfg.backup-$(date +%Y%m%d)
|
||||
```
|
||||
|
||||
⚠️ **After installing:**
|
||||
1. Run `CALIBRATION_QUICK` for essential calibrations
|
||||
2. Test with a simple print
|
||||
3. Fine-tune Pressure Advance for your filament
|
||||
|
||||
⚠️ **Carbon Fiber Filament:**
|
||||
- Use **ONLY** with Bambu Lab hotend (steel nozzle)
|
||||
- Will destroy brass nozzle!
|
||||
|
||||
---
|
||||
|
||||
## 📞 Support
|
||||
|
||||
- **Repo:** https://git.sky-net.it/nocci/open4neptune-new
|
||||
- **Open4Neptune:** https://github.com/OpenNeptune3D/OpenNept4une
|
||||
- **Klipper:** https://www.klipper3d.org/
|
||||
- **Cartographer:** https://cartographer3d.com/
|
||||
|
||||
---
|
||||
|
||||
**Created:** 2026-03-12
|
||||
**Printer:** Elegoo Neptune 4 Plus
|
||||
**Probe:** Cartographer 3D
|
||||
**Firmware:** Open4Neptune + Klipper
|
||||
**Hotends:** Original (15 mm³/s) + Bambu Lab (23 mm³/s)
|
||||
Loading…
Add table
Add a link
Reference in a new issue