SV08 Ultimate Build

Warning

Disclaimer

Questo è un progetto community e non ufficiale. Non è affiliato, sponsorizzato o approvato da Sovol o dagli altri progetti e produttori citati.

Le procedure, configurazioni e modifiche documentate in questo repository derivano da una migrazione realmente eseguita e testata su una specifica Sovol SV08, ma non costituiscono una garanzia di compatibilità o corretto funzionamento su ogni macchina.

Klipper, Katapult, Eddy, Phoenix Macros e gli altri componenti software evolvono nel tempo: quanto documentato qui rappresenta uno stato verificato del progetto, non necessariamente lo stato dell'arte corrente.

Flash del firmware, modifiche alla configurazione, cablaggi, calibrazioni e movimenti della macchina possono causare perdita della configurazione originale, malfunzionamenti o danni se eseguiti in modo errato.

!!! Chi utilizza questo repository lo fa sotto la propria responsabilità. !!! Prima di qualsiasi modifica, conserva backup verificati e assicurati di comprendere le operazioni che stai eseguendo.

Lingue: Italiano | English

Documentazione community per migrare una Sovol SV08 dallo stack software di fabbrica a Klipper Mainline corrente, includendo:

• configurazione CB1/Linux;
• backup, flashing e recovery delle MCU;
• sostituzione della toolhead originale con Sovol Zero Extruder Kit;
• sostituzione del piatto originale con piatto R3men in grafite;
• configurazione della stampante su Mainline;
• supporto Eddy nativo di Klipper;
• Phoenix Macros, sviluppate e validate durante la migrazione Phoenix;
• calibrazione;
• troubleshooting;
• rollback.

Le guide derivano da una migrazione reale end-to-end di una Sovol SV08 soprannominata Phoenix, ma il repository è strutturato in modo da tenere separati i valori e la cronologia specifici della Phoenix dalla baseline community riutilizzabile.

Da dove iniziare

Se stai migrando una Sovol SV08, segui le guide in questo ordine:

1. Getting started
2. Backup e rollback
3. Installazione CB1 e Klipper Mainline
4. Flashing e recovery delle MCU
5. Sovol Zero toolhead, Eddy nativo e piatto in grafite
6. Configurazione base Mainline
7. Eddy nativo
8. Phoenix Macros
9. Validazione e calibrazione
10. Troubleshooting

È disponibile anche un indice di compatibilità per i vecchi link:

Migrazione Klipper Mainline

Leggi prima di flashare qualsiasi cosa

Warning

Non iniziare cancellando o flashando le MCU.

Per maggiore sicurezza, durante la migrazione Phoenix il lavoro iniziale è stato eseguito da MicroSD anziché direttamente su eMMC. La MicroSD non offre necessariamente la stessa affidabilità o longevità di una buona eMMC, ma ha un vantaggio pratico importante: se qualcosa va storto può essere sostituita rapidamente e a basso costo con un supporto facilmente reperibile, senza dipendere dai tempi e dai costi di approvvigionamento di una nuova eMMC compatibile. Questo rende la MicroSD particolarmente utile come supporto di test, recovery e migrazione iniziale.

Prima di modificare il firmware, completa almeno:

• inventario del sistema stock;
• backup di printer.cfg e di tutti i file inclusi;
• backup di Moonraker e delle macro personalizzate;
• piano di rollback del sistema/eMMC;
• dump personali del firmware MCU originale quando possibile;
• verifica di aver compreso la procedura di recovery.

Vedi:

Backup e rollback

Cosa copre questo repository

Il percorso community documenta attualmente:

• migrazione dall'ambiente Klipper factory Sovol;
• ambiente Linux basato su CB1 usato dal controller Sovol stock;
• Klipper Mainline;
• migrazione firmware mainboard e toolboard;
• percorso di recovery/update basato su Katapult;
• identificazione stabile delle MCU tramite /dev/serial/by-id/;
• supporto nativo [probe_eddy_current ...];
• homing Z con Eddy nativo;
• QGL e bed mesh;
• integrazione Phoenix Macros;
• integrazione Machine G-code di OrcaSlicer;
• validazione del first layer;
• calibrazione filamento;
• troubleshooting basato su casi di guasto reali.

Baseline di migrazione verificata

La migrazione Phoenix ha raggiunto un sistema Mainline pienamente operativo con:

• Klipper Mainline v0.13.0-718-gd8659974-dirty;
• commit Klipper d865997403cad36d105026f73a4b76dcacec4c76;
• Moonraker;
• Mainsail;
• KlipperScreen;
• mainboard e toolboard con firmware compatibile Mainline;
• Eddy nativo tramite [probe_eddy_current eddy];
• G28 completo;
• probing nativo;
• QGL;
• bed mesh;
• Phoenix Macros;
• OrcaSlicer;
• stampa reale completata con successo dopo la migrazione.

Questi numeri di versione descrivono la baseline Phoenix realmente testata. Non sono un requisito per restare bloccati su quegli esatti commit.

Per una nuova migrazione, confronta sempre la documentazione upstream corrente prima di installare o patchare software.

Eddy nativo

La migrazione Phoenix inizialmente utilizzava il percorso esterno probe_eddy_ng.

Quel percorso è stato successivamente abbandonato perché l'ambiente Mainline corrente include già il supporto Eddy nativo e il plugin legacy creava problemi nel percorso di homing Z.

La documentazione community considera quindi:

[probe_eddy_current ...]

come baseline.

Vedi Eddy nativo.

Valori specifici Phoenix come offset, reg_drive_current, max_sensor_hz e curve di calibrazione sono esempi, non preset universali.

Phoenix Macros

La configurazione Phoenix corrente utilizza un proprio insieme di macro sopra Klipper Mainline.

Il 22 agosto 2026 è stato completato l'audit di separazione da DKEU. Il runtime corrente presenta:

• 21 macro PHOENIX_* definite ed esposte correttamente da Klipper;
• Core Pack;
• Calibration Pack;
• Debug Pack;
• Setup Pack;
• nessun include DKEU attivo;
• nessuna dipendenza runtime DKEU nei file Phoenix;
• nessun M84, force_move o save_variables nel layer Phoenix;
• bed mesh nativa Klipper con rapid scan e adaptive meshing nel workflow di stampa;
• componenti esterni mantenuti separati e attribuiti ai rispettivi progetti.

Tra le macro correnti rientrano PHOENIX_START, PHOENIX_END, PHOENIX_CLEAN_NOZZLE, gestione filamento, calibrazione PID/Input Shaper, diagnostica probe/mesh/sensori e helper di setup.

Il 23 agosto 2026 il blocco filamento è stato validato fisicamente sulla macchina: PHOENIX_LOAD_FILAMENT, PHOENIX_UNLOAD_FILAMENT, PHOENIX_FILAMENT_RUNOUT e PHOENIX_FILAMENT_CHANGE hanno completato correttamente i rispettivi workflow.

PHOENIX_PRESSURE_ADVANCE_TEST è stata rimossa intenzionalmente: la calibrazione Pressure Advance viene delegata allo slicer, evitando di mantenere una seconda procedura tower ridondante.

DKEU è stato utilizzato durante una fase importante della migrazione Phoenix e resta una origine storica/upstream da attribuire dove appropriato, ma non è più una dipendenza operativa della baseline corrente.

Vedi Phoenix Macros.

Filosofia di troubleshooting

La migrazione segue intenzionalmente un approccio basato sulle evidenze.

Se homing funziona, il probing è ripetibile, QGL converge e la mesh è coerente, ma la stampa è ancora errata, controlla override delle macro, riallineamento Z, profilo slicer, G-code generato e residui della migrazione software prima di modificare gantry, motori Z, viti del bed, axis twist o geometria meccanica.

Diversi problemi Phoenix che inizialmente sembravano meccanici si sono rivelati problemi software/configurazione.

Vedi Troubleshooting.

Caso di studio Phoenix

La cronologia completa e cronologica della migrazione è conservata separatamente sotto:

docs/migration-history/phoenix/

Contiene:

• stati intermedi;
• esperimenti falliti;
• workaround temporanei;
• misure;
• indagini sulle root cause;
• correzioni finali.

Questa cronologia è utile per debugging e archeologia tecnica. Non è la procedura di installazione step-by-step raccomandata.

Esempi Phoenix

Gli esempi specifici Phoenix sono conservati sotto:

examples/phoenix/

Possono includere:

• note hardware;
• profili OrcaSlicer;
• roadmap del progetto;
• valori specifici della macchina.

Non assumere che questi file possano essere copiati invariati su un'altra SV08.

Calibrazione

Il repository separa tre classi di calibrazione:

Macchina

Esempi:

• PID;
• configurazione stepper;
• endstop;
• heater.

Bed / Z

Esempi:

• calibrazione Eddy;
• QGL;
• riferimento Z;
• mesh;
• first layer.

Filamento

Esempi:

• temperatura;
• flow ratio;
• pressure advance;
• retraction;
• max volumetric speed.

Vedi Validazione e calibrazione.

Modifiche hardware

La baseline community Mainline è intenzionalmente separata dal successivo sviluppo hardware Phoenix.

Modifiche future o specifiche della macchina possono includere:

• modifiche enclosure;
• isolamento;
• redesign umbilical: Phoenix Umbilical Support.

Queste modifiche non devono ridefinire la procedura di migrazione base.

Progetti upstream

Questo progetto si basa sul lavoro delle community Klipper e SV08, inclusi:

• Klipper;
• Moonraker;
• Mainsail;
• KIAUH;
• Katapult;
• il lavoro Sovol SV08 Mainline di Rappetor;
• Demon Klipper Essentials Unified;
• OrcaSlicer.

Consulta sempre il progetto upstream pertinente prima di applicare vecchi workaround provenienti dalla cronologia di migrazione.

Ringraziamenti

Per primo desidero ringraziare Salvatore Crobu, che, malgrado fossimo ormai nel cuore della notte, non si è tirato indietro e mi ha dato suggerimenti che si sono rivelati molto utili.

Un ringraziamento anche al canale Noizie Works, il cui video sull'installazione del piatto in grafite R3men mi ha fornito un primo importante riferimento per affrontare questa modifica.

Desidero inoltre ringraziare tutti gli sviluppatori e la community di Demon Klipper Essentials Unified (DKEU) per l'eccellente lavoro svolto. DKEU ha avuto un ruolo importante durante una fase dello sviluppo di Phoenix, anche se successivamente il progetto ha seguito una propria linea evolutiva fino alla realizzazione delle Phoenix Macros.

Infine, grazie a tutti coloro che vorranno cimentarsi in questo viaggio e, in particolare, a chi contribuirà all'evoluzione del progetto segnalando bug, problemi, correzioni, miglioramenti o condividendo la propria esperienza.

Come già ampiamente indicato nell'introduzione, non mi assumo alcuna responsabilità per danni o errori derivanti dall'utilizzo delle procedure descritte in questo repository. Leggete, verificate e capite quello che state facendo prima di procedere: altrimenti il rischio è di ritrovarsi con un ingombrante porta abiti al posto di una stampante 3D.

Warning

Se installate un piatto in grafite con riscaldatore alimentato direttamente dalla rete, ricordate che 110 V o 230 V possono essere letali.

Lavorare sulla tensione di rete richiede competenza, isolamento adeguato, messa a terra, protezioni corrette e verifiche prima della messa in servizio. Se non avete esperienza con impianti elettrici a tensione di rete, non improvvisate e rivolgetevi a una persona qualificata.

Licenza

Il materiale originale di questo repository è distribuito secondo i termini della GNU General Public License v3.0 or later, nella misura in cui il relativo copyright sia detenuto dagli autori del progetto.

Vedi:

• LICENSE — testo completo della licenza;
• NOTICE.md — attribuzioni, materiale di terze parti, preset derivati e marchi.

I progetti upstream citati o utilizzati mantengono le rispettive licenze.