mirror of
https://github.com/Klipper3d/klipper.git
synced 2025-08-08 14:34:06 -06:00
Deploying to gh-pages from @ Klipper3d/klipper@14a83103c3 🚀
This commit is contained in:
KevinOConnor
parent
6478486f2c
commit
6d8124a0cc
303 changed files with 23968 additions and 2228 deletions
|
|
@ -480,8 +480,22 @@
|
|||
</li>
|
||||
|
||||
<li class="md-nav__item">
|
||||
<a href="#preparazione-dellimmagine-del-sistema-operativo" class="md-nav__link">
|
||||
Preparazione dell'immagine del sistema operativo
|
||||
<a href="#interacting-with-klipper" class="md-nav__link">
|
||||
Interacting with Klipper
|
||||
</a>
|
||||
|
||||
</li>
|
||||
|
||||
<li class="md-nav__item">
|
||||
<a href="#obtaining-an-os-image-for-sbcs" class="md-nav__link">
|
||||
Obtaining an OS image for SBC's
|
||||
</a>
|
||||
|
||||
</li>
|
||||
|
||||
<li class="md-nav__item">
|
||||
<a href="#installing-via-kiauh" class="md-nav__link">
|
||||
Installing via KIAUH
|
||||
</a>
|
||||
|
||||
</li>
|
||||
|
|
@ -491,13 +505,6 @@
|
|||
Compilare il firmware e flashare il microcontrollore
|
||||
</a>
|
||||
|
||||
</li>
|
||||
|
||||
<li class="md-nav__item">
|
||||
<a href="#configurare-octoprint-per-usare-klipper" class="md-nav__link">
|
||||
Configurare OctoPrint per usare Klipper
|
||||
</a>
|
||||
|
||||
</li>
|
||||
|
||||
<li class="md-nav__item">
|
||||
|
|
@ -522,8 +529,8 @@
|
|||
|
||||
|
||||
<li class="md-nav__item">
|
||||
<a href="OctoPrint.md" class="md-nav__link">
|
||||
None
|
||||
<a href="OctoPrint.html" class="md-nav__link">
|
||||
OctoPrint for Klipper
|
||||
</a>
|
||||
</li>
|
||||
|
||||
|
|
@ -1345,8 +1352,8 @@
|
|||
|
||||
|
||||
<li class="md-nav__item">
|
||||
<a href="Eddy_Probe.md" class="md-nav__link">
|
||||
None
|
||||
<a href="Eddy_Probe.html" class="md-nav__link">
|
||||
Eddy Current Inductive probe
|
||||
</a>
|
||||
</li>
|
||||
|
||||
|
|
@ -1408,8 +1415,22 @@
|
|||
</li>
|
||||
|
||||
<li class="md-nav__item">
|
||||
<a href="#preparazione-dellimmagine-del-sistema-operativo" class="md-nav__link">
|
||||
Preparazione dell'immagine del sistema operativo
|
||||
<a href="#interacting-with-klipper" class="md-nav__link">
|
||||
Interacting with Klipper
|
||||
</a>
|
||||
|
||||
</li>
|
||||
|
||||
<li class="md-nav__item">
|
||||
<a href="#obtaining-an-os-image-for-sbcs" class="md-nav__link">
|
||||
Obtaining an OS image for SBC's
|
||||
</a>
|
||||
|
||||
</li>
|
||||
|
||||
<li class="md-nav__item">
|
||||
<a href="#installing-via-kiauh" class="md-nav__link">
|
||||
Installing via KIAUH
|
||||
</a>
|
||||
|
||||
</li>
|
||||
|
|
@ -1419,13 +1440,6 @@
|
|||
Compilare il firmware e flashare il microcontrollore
|
||||
</a>
|
||||
|
||||
</li>
|
||||
|
||||
<li class="md-nav__item">
|
||||
<a href="#configurare-octoprint-per-usare-klipper" class="md-nav__link">
|
||||
Configurare OctoPrint per usare Klipper
|
||||
</a>
|
||||
|
||||
</li>
|
||||
|
||||
<li class="md-nav__item">
|
||||
|
|
@ -1453,22 +1467,27 @@
|
|||
|
||||
|
||||
<h1 id="installazione">Installazione<a class="headerlink" href="#installazione" title="Permanent link">¶</a></h1>
|
||||
<p>Queste istruzioni partono dal presupposto che Klipper girerà su un Raspberry Pi con OctoPrint. È consigliato l'utilizzo di un Raspberry Pi 2, 3 o 4 (vedi la <a href="FAQ.html#can-i-run-klipper-on-something-other-than-a-raspberry-pi-3">FAQ</a> per utilizzare un hardware diverso).</p>
|
||||
<p>These instructions assume the software will run on a linux based host running a Klipper compatible front end. It is recommended that a SBC(Small Board Computer) such as a Raspberry Pi or Debian based Linux device be used as the host machine (see the <a href="FAQ.html#can-i-run-klipper-on-something-other-than-a-raspberry-pi-3">FAQ</a> for other options).</p>
|
||||
<p>For the purposes of these instructions host relates to the Linux device and mcu relates to the printboard. SBC relates to the term Small Board Computer such as the Raspberry Pi.</p>
|
||||
<h2 id="ottenere-un-file-di-configurazione-di-klipper">Ottenere un file di configurazione di Klipper<a class="headerlink" href="#ottenere-un-file-di-configurazione-di-klipper" title="Permanent link">¶</a></h2>
|
||||
<p>La maggior parte delle impostazioni di Klipper sono determinate da un "file di configurazione della stampante" che verrà archiviato sul Raspberry Pi. Un file di configurazione appropriato può spesso essere trovato cercando in Klipper <a href="https://github.com/Klipper3d/klipper/blob/master/config/">directory config</a> un file che inizia con un prefisso "printer-" che corrisponde alla stampante di destinazione. Il file di configurazione di Klipper contiene informazioni tecniche sulla stampante che saranno necessarie durante l'installazione.</p>
|
||||
<p>Most Klipper settings are determined by a "printer configuration file" printer.cfg, that will be stored on the host. An appropriate configuration file can often be found by looking in the Klipper <a href="https://github.com/Klipper3d/klipper/blob/master/config/">config directory</a> for a file starting with a "printer-" prefix that corresponds to the target printer. The Klipper configuration file contains technical information about the printer that will be needed during the installation.</p>
|
||||
<p>Se non c'è un file di configurazione della stampante appropriato nella directory di configurazione di Klipper, prova a cercare nel sito web del produttore della stampante per vedere se hanno un file di configurazione di Klipper appropriato.</p>
|
||||
<p>Se non è possibile trovare alcun file di configurazione per la stampante, ma si conosce il tipo di scheda di controllo della stampante, cercare un <a href="https://github.com/Klipper3d/klipper/blob/master/config/">file di configurazione</a> appropriato che inizi con un prefisso "generico-". Questi file di esempio della scheda della stampante dovrebbero consentire di completare correttamente l'installazione iniziale, ma richiederanno alcune personalizzazioni per ottenere la funzionalità completa della stampante.</p>
|
||||
<p>È anche possibile definire da zero una nuova configurazione della stampante. Tuttavia, ciò richiede una conoscenza tecnica significativa sulla stampante e la sua elettronica. Si consiglia alla maggior parte degli utenti di iniziare con un file di configurazione appropriato. Se si crea un nuovo file di configurazione della stampante personalizzato, iniziare con l'esempio più vicino <a href="https://github.com/Klipper3d/klipper/blob/master/config/">file di configurazione</a> e utilizzare Klipper <a href="Config_Reference.html">riferimento alla configurazione</a> per ulteriori informazioni.</p>
|
||||
<h2 id="preparazione-dellimmagine-del-sistema-operativo">Preparazione dell'immagine del sistema operativo<a class="headerlink" href="#preparazione-dellimmagine-del-sistema-operativo" title="Permanent link">¶</a></h2>
|
||||
<p>Iniziate installando <a href="https://github.com/guysoft/OctoPi">OctoPi</a> sul computer Raspberry Pi. Usa OctoPi v0.17.0 o successivo - vedi <a href="https://github.com/guysoft/OctoPi/releases">OctoPi releases</a> per informazioni sulla versione. Si dovrebbe verificare che OctoPi si avvii e che il server web OctoPrint funzioni. Dopo essersi collegati alla pagina web OctoPrint, segui la richiesta di aggiornare OctoPrint alla v1.4.2 o successiva.</p>
|
||||
<p>Dopo aver installato OctoPi ed aver aggiornato OctoPrint all'ultima versione sarà necessario loggarsi via ssh sul Raspberry (o altra macchina scelta per far girare klipper) per eseguire una manciata di comandi. Se stai utilizzando un sistema Linux o MacOS desktop, il programma "ssh" potrebbe già essere installato sul tuo sistema. Esistono vari client ssh disponibili (ad esempio <a href="https://www.chiark.greenend.org.uk/~sgtatham/putty/">PuTTY</a>). Usa il programma ssh per connetterti al Raspberry Pi (ssh pi@octopi -- la password è "raspberry") ed esegui questi comandi:</p>
|
||||
<div class="highlight"><pre><span></span><code>git clone https://github.com/Klipper3d/klipper
|
||||
./klipper/scripts/install-octopi.sh
|
||||
</code></pre></div>
|
||||
|
||||
<p>Questo scaricherà Klipper, installerà alcune dipendenze, imposterà Klipper per essere eseguito all'avvio del sistema e avvierò il programma host Klipper. Sarà necessario che il Raspberry abbia accesso ad internet e richederà alcuni minuti.</p>
|
||||
<h2 id="interacting-with-klipper">Interacting with Klipper<a class="headerlink" href="#interacting-with-klipper" title="Permanent link">¶</a></h2>
|
||||
<p>Klipper is a 3d printer firmware, so it needs some way for the user to interact with it.</p>
|
||||
<p>Currently the best choices are front ends that retrieve information through the <a href="https://moonraker.readthedocs.io/">Moonraker web API</a> and there is also the option to use <a href="https://octoprint.org/">Octoprint</a> to control Klipper.</p>
|
||||
<p>The choice is up to the user on what to use, but the underlying Klipper is the same in all cases. We encourage users to research the options available and make an informed decision.</p>
|
||||
<h2 id="obtaining-an-os-image-for-sbcs">Obtaining an OS image for SBC's<a class="headerlink" href="#obtaining-an-os-image-for-sbcs" title="Permanent link">¶</a></h2>
|
||||
<p>There are many ways to obtain an OS image for Klipper for SBC use, most depend on what front end you wish to use. Some manafactures of these SBC boards also provide their own Klipper-centric images.</p>
|
||||
<p>The two main Moonraker based front ends are <a href="https://docs.fluidd.xyz/">Fluidd</a> and <a href="https://docs.mainsail.xyz/">Mainsail</a>, the latter of which has a premade install image <a href="http://docs.mainsailOS.xyz">"MainsailOS"</a>, this has the option for Raspberry Pi and some OrangePi varianta.</p>
|
||||
<p>Fluidd can be installed via KIAUH(Klipper Install And Update Helper), which is explained below and is a 3rd party installer for all things Klipper.</p>
|
||||
<p>OctoPrint can be installed via the popular OctoPi image or via KIAUH, this process is explained in <OctoPrint.md></p>
|
||||
<h2 id="installing-via-kiauh">Installing via KIAUH<a class="headerlink" href="#installing-via-kiauh" title="Permanent link">¶</a></h2>
|
||||
<p>Normally you would start with a base image for your SBC, RPiOS Lite for example, or in the case of a x86 Linux device, Ubuntu Server. Please note that Desktop variants are not recommended due to certain helper programs that can stop some Klipper functions working and even mask access to some print boards.</p>
|
||||
<p>KIAUH can be used to install Klipper and its associated programs on a variety of Linux based systems that run a form of Debian. More information can be found at <a href="https://github.com/dw-0/kiauh">https://github.com/dw-0/kiauh</a></p>
|
||||
<h2 id="compilare-il-firmware-e-flashare-il-microcontrollore">Compilare il firmware e flashare il microcontrollore<a class="headerlink" href="#compilare-il-firmware-e-flashare-il-microcontrollore" title="Permanent link">¶</a></h2>
|
||||
<p>Per compilare il firmware per il microcontrollore, iniziamo lanciando questi comandi sul Raspberry:</p>
|
||||
<p>To compile the micro-controller code, start by running these commands on your host device:</p>
|
||||
<div class="highlight"><pre><span></span><code>cd ~/klipper/
|
||||
make menuconfig
|
||||
</code></pre></div>
|
||||
|
|
@ -1486,26 +1505,28 @@ make menuconfig
|
|||
<div class="highlight"><pre><span></span><code>/dev/serial/by-id/usb-1a86_USB2.0-Serial-if00-port0
|
||||
</code></pre></div>
|
||||
|
||||
<p>È abbastanza comune che ogni stampante 3D abbia il suo nome univoco elencato come porta seriale. Questo nome sarà utilizzato quando flasheremo il microcontrollore. È possibile che ci possano essere più righe nell'elenco sopraccitato, se è così seleziona la riga cosrrispondente al microcontrollore (vedi le <a href="FAQ.html#wheres-my-serial-port">FAQ</a> per maggiori informazioni).</p>
|
||||
<p>Per i microcontrollori più comuni, il firmware può essere flashato con comandi tipo:</p>
|
||||
<p>It's common for each printer to have its own unique serial port name. This unique name will be used when flashing the micro-controller. It's possible there may be multiple lines in the above output - if so, choose the line corresponding to the micro-controller. If many items are listed and the choice is ambiguous, unplug the board and run the command again, the missing item will be your print board(see the <a href="FAQ.html#wheres-my-serial-port">FAQ</a> for more information).</p>
|
||||
<p>For common micro-controllers with STM32 or clone chips, LPC chips and others it is usual that these need an initial Klipper flash via SD card.</p>
|
||||
<p>When flashing with this method, it is important to make sure that the print board is not connected with USB to the host, due to some boards being able to feed power back to the board and stopping a flash from occuring.</p>
|
||||
<p>For common micro-controllers using Atmega chips, for example the 2560, the code can be flashed with something similar to:</p>
|
||||
<div class="highlight"><pre><span></span><code>sudo service klipper stop
|
||||
make flash FLASH_DEVICE=/dev/serial/by-id/usb-1a86_USB2.0-Serial-if00-port0
|
||||
sudo service klipper start
|
||||
</code></pre></div>
|
||||
|
||||
<p>Assicurati di mettere al posto di FLASH_DEVICE il nome della porta seriale associato alla stampante.</p>
|
||||
<p>Quando flashi il firmware per la prima volta verifica che OctoPrint non sia connesso alla stampante (dall'interfaccia di OctoPrint, nella sezione "Connection", clicca "Disconnect").</p>
|
||||
<h2 id="configurare-octoprint-per-usare-klipper">Configurare OctoPrint per usare Klipper<a class="headerlink" href="#configurare-octoprint-per-usare-klipper" title="Permanent link">¶</a></h2>
|
||||
<p>Il sistema OctoPrint deve essere configurato per comunicare con il sistema Klipper. Loggati su OctoPrint e confogura queste parti:</p>
|
||||
<p>Naviga nella scheda Impostazioni (la chiave inglese in cima alla pagina). Dentro "Serial Connection", "Additional serial ports" aggiungi "/tmp/printer". Poi fai "Save".</p>
|
||||
<p>Vai nella scheda Impostazioni e sotto "Serial Connection" cambia la "Serial Port" in "/tmp/printer".</p>
|
||||
<p>Nella scheda Impostazioni, vai in "Behavior" e seleziona l'opzione "Cancel any ongoing prints but stay connected to the printer", poi "Save".</p>
|
||||
<p>Dalla pagina principale, nella sezione "Connection" in alto a sinistra, verifica che il campo "Serial Port" sia "/tmp/printer" e clicca "Connect". Se l'opzione /tmp/printer non è visualizzata prova a ricaricare la pagina.</p>
|
||||
<p>Una volta connesso, vai nella scheda "Terminal" e scrivi il comando "status" (senza virgolette) nella casella per i comandi e clicca "Send". La finestra del terminare probabilmente mostrerà un messaggio di errore sull'apertura del file config, questo significa che OctoPrint sta comunicando correttamente con Klipper. Possiamo proseguire.</p>
|
||||
<p>For common micro-controllers using RP2040 chips, the code can be flashed with something similar to:</p>
|
||||
<div class="highlight"><pre><span></span><code>sudo service klipper stop
|
||||
make flash FLASH_DEVICE=first
|
||||
sudo service klipper start
|
||||
</code></pre></div>
|
||||
|
||||
<p>It is important to note that RP2040 chips may need to be put into Boot mode before this operation.</p>
|
||||
<h2 id="configurare-klipper">Configurare Klipper<a class="headerlink" href="#configurare-klipper" title="Permanent link">¶</a></h2>
|
||||
<p>Il passaggio successivo consiste nel copiare il <a href="#obtain-a-klipper-configuration-file">file di configurazione della stampante</a> sul Raspberry Pi.</p>
|
||||
<p>Probabilmente il modo più semplice per impostare il file di configurazione di Klipper è utilizzare un editor desktop che supporti la modifica dei file sui protocolli "scp" e/o "sftp". Ci sono strumenti disponibili gratuitamente che supportano questo (ad esempio, Notepad++, WinSCP e Cyberduck). Caricare il file di configurazione della stampante nell'editor e quindi salvarlo come file denominato "printer.cfg" nella directory home dell'utente pi (ad esempio, /home/pi/printer.cfg).</p>
|
||||
<p>In alternativa, si può anche copiare e modificare il file direttamente sul Raspberry Pi tramite ssh. Potrebbe essere simile al seguente (assicurati di aggiornare il comando per utilizzare il nome file di configurazione della stampante appropriato):</p>
|
||||
<p>The next step is to copy the <a href="#obtain-a-klipper-configuration-file">printer configuration file</a> to the host.</p>
|
||||
<p>Arguably the easiest way to set the Klipper configuration file is using the built in editors in Mainsail or Fluidd. These will allow the user to open the configuration examples and save them to be printer.cfg.</p>
|
||||
<p>Another option is to use a desktop editor that supports editing files over the "scp" and/or "sftp" protocols. There are freely available tools that support this (eg, Notepad++, WinSCP, and Cyberduck). Load the printer config file in the editor and then save it as a file named "printer.cfg" in the home directory of the pi user (ie, /home/pi/printer.cfg).</p>
|
||||
<p>Alternatively, one can also copy and edit the file directly on the host via ssh. That may look something like the following (be sure to update the command to use the appropriate printer config filename):</p>
|
||||
<div class="highlight"><pre><span></span><code>cp ~/klipper/config/example-cartesian.cfg ~/printer.cfg
|
||||
nano ~/printer.cfg
|
||||
</code></pre></div>
|
||||
|
|
@ -1523,9 +1544,9 @@ nano ~/printer.cfg
|
|||
serial: /dev/serial/by-id/usb-1a86_USB2.0-Serial-if00-port0
|
||||
</code></pre></div>
|
||||
|
||||
<p>Dopo aver creato e modificato il file sarà necessario emettere un comando di "restart" nel terminale web di OctoPrint per caricare il file config. Un comando "status" segnalerà che la stampante è pronta se il file di configurazione di Klipper viene letto correttamente e il microcontrollore è stato trovato e configurato correttamente.</p>
|
||||
<p>After creating and editing the file it will be necessary to issue a "restart" command in the command console to load the config. A "status" command will report the printer is ready if the Klipper config file is successfully read and the micro-controller is successfully found and configured.</p>
|
||||
<p>Quando si personalizza il file di configurazione della stampante, non è raro che Klipper segnali un errore di configurazione. Se si verifica un errore, apportare le correzioni necessarie al file di configurazione della stampante ed eseguire il "restart" finché "status" non segnala che la stampante è pronta.</p>
|
||||
<p>Klipper riferisce i messaggi di errore tramite il terminale di OctoPrint. Il comando "status" può essere usato per visualizzare nuovamente eventuali messaggi di errore. Lo script di startup di default di Klipper genererà un log sotto <strong>/tmp/klippy.log</strong>, questo fornirà informazioni più dettagliate.</p>
|
||||
<p>Klipper reports error messages via the command console and via pop up in Fluidd and Mainsail. The "status" command can be used to re-report error messages. A log is available and usually located in ~/printer_data/logs this is named klippy.log</p>
|
||||
<p>Dopo che Klipper ha segnalato che la stampante è pronta, vai al <a href="Config_checks.html">config check document</a> per eseguire alcuni controlli di base sulle definizioni nel file di configurazione. Vedere i<a href="Overview.html">documentation reference</a> per altre informazioni.</p>
|
||||
|
||||
|
||||
|
|
@ -1561,13 +1582,13 @@ serial: /dev/serial/by-id/usb-1a86_USB2.0-Serial-if00-port0
|
|||
|
||||
|
||||
|
||||
<a href="Config_Reference.html" class="md-footer__link md-footer__link--next" aria-label="Prossimo: Riferimenti configurazione" rel="next">
|
||||
<a href="OctoPrint.html" class="md-footer__link md-footer__link--next" aria-label="Prossimo: OctoPrint for Klipper" rel="next">
|
||||
<div class="md-footer__title">
|
||||
<div class="md-ellipsis">
|
||||
<span class="md-footer__direction">
|
||||
Prossimo
|
||||
</span>
|
||||
Riferimenti configurazione
|
||||
OctoPrint for Klipper
|
||||
</div>
|
||||
</div>
|
||||
<div class="md-footer__button md-icon">
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue